Englishواجهة برمجة تطبيقات REST بسيطة لـ إرسال الرسائل القصيرة
قم بنشر المرسل والمستلم والمحتوى الخاص بك باستخدام رأس الرمز المميز. احصل على معرف الرسالة مباشرة، ودفع تقارير التسليم إلى الخادم الخاص بك.
طلب واحد، رسالة واحدة
قم بالمصادقة باستخدام مفتاح الوصول الخاص بك، ثم قم بنشر الرسالة، واقرأ الرسالة من الرد. اضغط على الزر لرؤيته يعمل.
1curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \
2 -H "Token: $SMSLOCAL_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "from": "SMSLOCAL",
6 "to": "14155550123",
7 "content": "Your code is 481920."
8 }'
/external/smsقم بتشغيل الطلب لرؤية الرد.
لا شيء غريب للتعلم
ثلاث أفكار تغطي واجهة برمجة التطبيقات بأكملها، والتي تتبع بشكل عادي استراحة الاتفاقيات.
- المصادقة
مصادقة الرمز المميز
أرسل مفتاح الوصول الخاص بك في رأس الرمز المميز عند كل طلب، مع إدخال JSON وإخراج JSON.
- لا حاجة إلى SDK
- يعمل من أي لغة
- احتفظ بالمفتاح في متغير البيئة
- إجابة
مع العلم أنه تم قبوله
تقوم كل عملية إرسال بإرجاع رسالة ورمز خطأ على الفور.
- قم بتخزين msgid مقابل السجل الخاص بك
- رمز الخطأ 0 يعني قبوله
- استخدم msgid لمطابقة التقارير لاحقًا
- الردود
في اتجاهين بشكل افتراضي
تصل الردود في نفس رد الاتصال، الذي تم وضع علامة عليه على أنه تم إنشاء الهاتف المحمول.
- نفس شكل الرسالة مثل التقارير
- أخبر الاتجاهات بصرف النظر عن mt / mo
- توجيه الردود إلى أدوات الدعم الخاصة بك
انظر ماذا حدث لكل رسالة
يتم نشر تقرير الحالة لديك عنوان URL لرد الاتصال عندما تصل الرسالة إلى حالتها النهائية.
- 1المطابقة بواسطة msgstrيحمل كل تقرير المعرف الذي تم إعطاؤه لك في وقت الإرسال.
- 2الحالات النهائية فقطتسمع عن رسالة عند تسليمها أو فشلها.
- 3عنوان URL واحد لرد الاتصالتتلقى نفس نقطة النهاية التقارير والردود.
9f2a7c10+1 415 ••• 0123تم التوصيلالآن9f2a7c11+91 98••• 43210تم التوصيلمنذ 3 ثواني9f2a7c12+44 7••• 123456قيد الانتظارمنذ 5 ثواني9f2a7c13+91 99••• 00012فشلمنذ 9 ثواني
انظر كيف يتم حساب الرسالة
يؤدي النص الأطول والأحرف غير اللاتينية إلى تغيير عدد الأجزاء التي تتم فوترة الرسالة بها. جرب الصياغة الخاصة بك، و ابحث عن رقم قبل أن ترسل.
- جزء 146 / 160
جزء واحد يحمل 160 حرفًا في GSM7 أو 70 في Unicode. يقوم حرف واحد غير GSM، مثل رمز تعبيري أو حرف هندي، بتحويل الرسالة بأكملها إلى Unicode.
توقف عن لصق الرسائل معًا يدويًا
اسحب الفاصل للمقارنة.
- الرسائل المرسلة من الكود الخاص بك
- تقرير لكل رسالة
- الردود دفعت إلى النظام الخاص بك
- عمليات التصدير والتحميلات اليدوية
- لا فكرة إذا وصلت الرسالة
- تصل الردود إلى البريد الوارد لشخص ما
قائمة مرجعية قصيرة قبل الإطلاق
ضع علامة على العناصر كما تذهب. لا شيء هنا محفوظ.
SMS API — الأسئلة المتداولة
قم بتمرير مفتاح الوصول الخاص بك في رأس الرمز المميز في كل طلب، بالإضافة إلى نوع المحتوى: application/json.
كل إرسال يقوم بإرجاع msgid. قم بتوجيهنا إلى عنوان URL لرد الاتصال ونقوم بنشر تقرير حالة إليه عندما تصل الرسالة إلى حالتها النهائية.
160 حرفًا بتشفير GSM7، أو 70 حرفًا بترميز Unicode. يتم ضم الرسائل الأطول من عدة أجزاء، ويتم إصدار فاتورة لكل منها على حدة.
نعم. يتم تسليم الردود الواردة إلى نفس عنوان URL لرد الاتصال ويتم وضع علامة عليها على أنها نشأت من الهاتف المحمول.
نعم. يجب أن تستخدم الرسائل النصية القصيرة إلى الأرقام الهندية كيانًا معتمدًا ورأس المرسل والقالب. يساعدك فريقنا على تسجيلهم أثناء الإعداد.
أرسل أول رسالة نصية قصيرة لك في دقائق
قم بإنشاء حساب، واحصل على مفتاح الوصول الخاص بك وقم بتقديم طلبك الأول.