دليل تنفيذ LINK Mobility REST API SMS
توفر LINK Mobility خدمة توصيل الرسائل والمدفوعات الصغيرة والخدمات القائمة على الموقع. تعمل المنصة كمصدر شفاف للمحتوى وموجه للمعاملات بين مقدمي الخدمة والمشغلين.
توفر LINK Mobility واجهة برمجة تطبيقات RESTful يمكن استخدامها للوصول إلى خدمات LINK Mobility مثل إرسال الرسائل القصيرة. تم تصميم واجهة برمجة التطبيقات هذه لتكون سهلة الاستخدام ومتوافقة مع جميع اللغات والأطر الحديثة. باستخدام اللغة التي تختارها، يمكن لتطبيقك استخدام واجهة برمجة تطبيقات Link Mobility REST لتنفيذ إمكانيات المراسلة والدفع القوية
© LINK Mobility، 10 مارس 2021
المعلومات القانونية
المعلومات الواردة في هذه الوثيقة هي ملكية خاصة وحقوق نشر لشركة Netsize. وهي سرية ومخصصة للاستخدام المعلوماتي فقط. وهي غير ملزمة وقد تخضع للتغيير دون إشعار. ويعتبر أي إفصاح أو استخدام غير مصرح به غير قانوني.
تخضع Netsize™ وlinkmobility™ لحماية قوانين الملكية الفكرية الفرنسية وقوانين الجماعة الاقتصادية الأوروبية والقوانين الدولية.
جميع العلامات التجارية الأخرى المذكورة هي ملكية حصرية لأصحابها.
لا يجوز تفسير أي شيء موجود هنا على أنه يمنح أي ترخيص أو حق بموجب براءة اختراع Netsize أو حقوق الطبع والنشر أو العلامة التجارية.
حجم الشبكة
شركة مجهولة برأس مال 5 يورو
Siège Social :62 شارع إميل زولا 92100 بولوني – فرنسا
418 712 477 RCS نانتير
http://www.LinkMobility.com
http://www.linkmobility.com
نطاق الوثيقة
يصف هذا المستند كيفية استخدام مزود الخدمة لواجهة برمجة تطبيقات LINK Mobility REST للرسائل القصيرة. وهو مخصص للمهندسين المعماريين والمصممين الفنيين الذين ينفذون خدمات مزود الخدمة.
1. الاستخدام الأساسي
من السهل جدًا إرسال رسالة نصية قصيرة. يمكنك إرسال طلب HTTP إلى LINK Mobility والذي يمكن إنجازه باستخدام web المتصفح.
2. انتهى العملview
يوفر نظام LINK Mobility الوظائف الأساسية التالية للرسائل النصية القصيرة:
إرسال رسائل SMS منتهية الصلاحية عبر الهاتف المحمول (MT)، مثل الرسائل النصية أو الثنائية (مثل WAP Push) والرسائل المميزة والقياسية.
استلام تقارير التسليم للرسائل MT المرسلة.
استقبال رسائل SMS الصادرة من الهاتف المحمول (MO)، بأسعار مميزة وقياسية.
تم تصميم واجهة برمجة تطبيقات SMS REST لإرسال رسائل SMS MT بمعدل قياسي.
ترسل واجهة برمجة التطبيقات (API) جميع رسائل SMS بشكل غير متزامن، مما يتيح ميزات مثل:
"أطلق وانسى" - يريد مزود الخدمة أن تكون أوقات الاستجابة أكثر قابلية للتنبؤ ولا يريد انتظار النتيجة من المشغل.
وظيفة إعادة المحاولة – سوف تقوم LINK Mobility بإعادة إرسال الرسالة إذا كان لدى المشغل مشاكل مؤقتة.
2.1 إرسال رسالة نصية قصيرة
مزود الخدمة Netsize المستهلك
- إرسال رسالة MT
- معرف رسالة الإرجاع
- إرسال رسالة نصية قصيرة
- تسليم تقرير التسليم
- إرسال تقرير التسليم
يتم وصف التدفق الأساسي لإرسال رسائل SMS على النحو التالي:
يقوم مزود الخدمة بتقديم طلب لإرسال رسالة نصية قصيرة إلى المستلم عبر نظام LINK Mobility.
يتم إرجاع معرف الرسالة إلى مزود الخدمة. يمكن استخدام هذا المعرف لربط الرسالة بتقرير التسليم الصحيح على سبيل المثال.
تتولى LINK Mobility مسؤولية التوجيه وتسليم رسالة SMS إلى المستهلك المحدد.
يتم تشغيل تقرير التسليم، على سبيل المثال، عندما يتم تسليم رسالة SMS إلى جهاز المستهلك.
يتم إرسال تقرير التسليم إلى موفر الخدمة. يحتوي التقرير على نفس معرف الرسالة الذي تم إرجاعه في الخطوة 2.
التدفق البديل: طلب غير صالح
إذا كانت المعلمات المقدمة أو بيانات اعتماد المستخدم في الطلب غير صالحة، فسيتم إرجاع خطأ إلى موفر الخدمة. يشير الخطأ إلى سبب الرفض وينتهي التدفق. لا يتم إرجاع أي معرفات للرسائل.
3. نقطة النهاية
يتم الوصول إلى مورد SMS باستخدام المسار:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
من أجل أمان الاتصال، لا يمكن الوصول إلى واجهة برمجة تطبيقات LINK Mobility REST إلا عبر HTTPS.
تم توقيع شهادة خادم Link Mobility بواسطة Thawte Server CA.
4. العمليات
توفر خدمة الرسائل القصيرة العمليات التالية:
| اسم | طريق |
| يرسل | /restapi/v1/sms/إرسال |
4.1 إرسال
يتم استخدام عملية الإرسال لإرسال رسالة نصية قصيرة إلى مستلم واحد.
هذه العملية مخصصة للمستخدمين الأساسيين والمتقدمين. في أبسط الحالات، لا يلزم سوى عنوان الوجهة ونص الرسالة لتسليم رسالة نصية قصيرة. سيكتشف LINK Mobility مخطط ترميز البيانات ويقوم بربط الرسالة تلقائيًا إلى أجزاء رسالة متعددة إذا لزم الأمر.
بالنسبة للاستخدام المتقدم، يمكن لمزود الخدمة استخدام معلمات اختيارية للتحكم الكامل في تنسيق الرسالة بما في ذلك رأس بيانات المستخدم.
يمكن لمزود الخدمة إرسال رسائل متسلسلة، ولكن يجب أن يتم إعداد بيانات المستخدم ورأس بيانات المستخدم بواسطة مزود الخدمة ويجب إرسال الرسالة عن طريق طلبات إرسال متعددة نحو LINK Mobility.
5. المصادقة
يتم تقديم اسم المستخدم وكلمة المرور في كل طلب باستخدام مخطط المصادقة الأساسي HTTP.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
يتم إرسال بيانات الاعتماد في رأس التفويض في طلب HTTP. يقوم العميل بإنشاء حقل الرأس كما هو موضح هنا:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
على سبيل المثالampعلى سبيل المثال، إذا كان اسم المستخدم هو john وchangeme هي كلمة المرور، فإن رأس التفويض الناتج يكون:
التفويض: أساسي am9objpjaGFuZ2VtZSA=
كحل بديل، يمكن تقديم اسم المستخدم وكلمة المرور كمعلمات طلب. لا يُنصح بذلك إلا للعملاء الذين لا يدعمون المصادقة الأساسية.
6. تقديم الطلب
6.1 سلسلة الاستعلام
يتم إرسال معلمات الطلب كسلسلة استعلام تحتوي على أزواج الاسم/القيمة. يتم ترميز سلسلة الاستعلام باستخدام ترميز النسبة المئوية (URL (الترميز).
http://www.w3schools.com/tags/ref_urlencode.asp
على سبيل المثالample, Hello World! يتم ترميزه كـ Hello+World%21.
6.2 معلمات الطلب الإلزامية
| اسم | الطول الأقصى | وصف |
| عنوان الوجهة | 40 | رقم MSISDN الذي يجب إرسال رسالة SMS إليه، بدءًا برمز الدولة.ampجنيه: 46123456789. بالنسبة لبعض الأسواق (حيث يجب إخفاء رقم MSISDN للمستهلك)، يمكن أن تكون هذه القيمة أيضًا اسمًا مستعارًا أبجديًا رقميًا، مسبوقًا بـ "#". |
| رسالة نصية | 1600 | محتوى الرسالة النصية القصيرة. |
6.3 معلمات الطلب الاختيارية (للاستخدام المتقدم)
| اسم | الطول الأقصى | وصف |
| العنوان الأصلي | 16 | عنوان المنشأ للرسالة النصية القصيرة الصادرة. يتم تحديد نوع عنوان المنشأ بواسطة معلمة originatorTON. الحد الأقصى لطول الرقم القصير هو 16. يقتصر المرسل الرقمي الأبجدي على الأبجدية الافتراضية لنظام GSM بحد أقصى يبلغ 11 حرفًا. الحد الأقصى لطول مرسل MSISDN هو 15 (باستخدام نفس التنسيق مثل عنصر destinationAddress). يمكن حذفها عند تحديد عنوان المصدر وTON المصدر بواسطة النظام. تعتمد هذه الوظيفة على السوق والتكوين. قد يختلف السلوك مع تكاملات المشغل. |
| المنشئTON | 1 | نوع رقم العنوان الأصلي (TON): 0 – رقم قصير 1 – أبجدي رقمي (الحد الأقصى للطول 11) 2- رقم هاتف الخدمة يمكن حذفه عند تحديد عنوان المنشأ ورقم المنشأ TON بواسطة النظام. تعتمد هذه الوظيفة على السوق والتكوين. قد يختلف السلوك مع تكاملات المشغل. |
| رأس بيانات المستخدم | 280 | يمكن أن يحتوي رأس بيانات المستخدم مع بيانات المستخدم على ما يصل إلى 140، أي 280 عند ترميزها بنظام سداسي عشري، من ثماني بتات. يتم ترميز هذه المعلمة دائمًا بنظام سداسي عشري. |
| دي سي إس | 3 | مخطط ترميز البيانات. قد يختلف السلوك مع تكاملات المشغل. |
| معرف المنتج | 3 | معرف البروتوكول. قد يختلف السلوك مع تكاملات المشغل. |
| وقت الصلاحية النسبي | 6 | وقت الصلاحية النسبي بالثواني (بالنسبة إلى وقت الإرسال إلى LINK Mobility). القيمة القصوى هي 604800 (7 أيام) والقيمة الافتراضية هي 48 ساعة. قد يختلف السلوك مع تكاملات المشغل. |
| موعد التسليم | 20 | توقيتamp متى يجب تسليم رسالة SMS (وقت التسليم المتأخر). راجع القسم الخاص بتنسيق التاريخ والوقت. |
| حالة التقارير | 1 | طلب تقديم التقرير: 0 – لا يوجد تقرير تسليم (افتراضي) 1- طلب تقرير التسليم 9 - طلب تقرير تسليم الخادم (لا يقوم LINK Mobility بإرسال التقرير إلى مزود الخدمة ولكنه يجعله متاحًا في التقارير وما إلى ذلك) |
| campاسم الموقع | 50 | معاملات LINK Mobility هي tagتم إنشاؤه بهذا الاسم. يتم استخدامه لتجميع المعاملات في تقارير Link Mobility. |
| أقصى عدد من الرسائل المتسلسلة | 1 | قيمة تتراوح بين 1 و10 تحدد عدد الرسائل المتسلسلة المسموح بها. القيمة الافتراضية هي 3. |
| معرف الارتباط | 100 | سيتم عرض المعرف الذي يوفره مزود الخدمة في تقرير التسليم. |
| اسم المستخدم | 100 | يتم توفيره كبديل لمصادقة HTTP الأساسية. |
| كلمة المرور | 100 | يتم توفيره كبديل لمصادقة HTTP الأساسية. |
6.4 طرق طلب HTTP
لتحقيق أقصى قدر من التوافق، تدعم واجهة برمجة التطبيقات كلاً من طريقتي طلب HTTP GET وPOST. ولا يُسمح بأي طرق HTTP أخرى.
6.4.1 الحصول على
يتم إلحاق سلسلة الاستعلام المشفرة بـ URL.
يحصل
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=مرحبا بالعالم%21
التفويض: أساسي am9objpjaGFuZ2VtZSA=
6.4.2 وظيفة
يتم إرسال سلسلة الاستعلام المشفرة في نص رسالة طلب HTTP. نوع المحتوى هو application/x-www-form-urlمشفر.
بريد https://europe.ipx.com/restapi/v1/sms/send
المضيف: europe.ipx.com
نوع المحتوى: application / x-www-form-urlمُشفّر
التفويض: أساسي am9objpjaGFuZ2VtZSA=
طول المحتوى: 57
العنوان المقصود=46123456789&نص الرسالة=مرحبا بالعالم%21
6.5 التاريخ والوقت
تكون المعلمات في واجهة برمجة التطبيقات REST التي تمثل التاريخ والوقت دائمًا في المنطقة الزمنية UTC (التوقيت العالمي المنسق).ampيتم تمثيل s كسلسلة بهذا التنسيق الدقيق:
2017-04-25T23:20:50Z
ويمثل هذا 20 دقيقة و50 ثانية بعد الساعة 23 من يوم 25 أبريل 2017 بتوقيت UTC.
7. رسالة الرد
بعد استلام رسالة الطلب وتفسيرها، تستجيب واجهة برمجة التطبيقات برسالة استجابة HTTP.
7.1 رمز حالة HTTP
تعيد واجهة برمجة التطبيقات REST دائمًا رمز حالة HTTP 200 OK للطلبات المعالجة. يحتوي نص الرسالة على معلمة responseCode التي تُستخدم لتحديد النتيجة الدقيقة.
7.2 نص الرسالة
يتكون نص الرسالة من JSON الذي يصف نتيجة الطلب.
http://json.org/
يتوافق Link Mobility JSON مع دليل نمط Google JSON.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 معلمات الاستجابة
| اسم | الطول الأقصى | وصف |
| رمز الاستجابة | 3 | يشير 0 إلى معاملة ناجحة. |
| رسالة الرد | 255 | وصف نص الاستجابة، على سبيل المثال نص الخطأ. |
| توقيتamp | 20 | التاريخ والوقت الذي قامت فيه LINK Mobility بمعالجة الطلب. (راجع قسم تنسيق التاريخ/الوقت). |
| معرف التتبع | 36 | معرف داخلي لـ Link Mobility. يُستخدم للدعم واستكشاف الأخطاء وإصلاحها. |
| معرفات الرسائل | 10 × 36 | مجموعة من معرفات رسائل LINK Mobility الفريدة لكل رسالة ناجحة (يتم إرجاع معرفات رسائل متعددة إذا تم تجميع الرسالة). تم حذفه في حالة الفشل. |
7.4 مثالampالاستجابات
نجاح
HTTP/1.1 200 موافق
نوع المحتوى: application/json
طول المحتوى: 144
التاريخ: الخميس 15 سبتمبر 2016 13:20:31 بتوقيت جرينتش
{“responseCode”:0،”responseMessage”:”نجاح”،”أحدث وقتamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
هذا هو نفس تنسيق JSON لسهولة القراءة:
{
"رمز الاستجابة":0,
"رسالة الرد":"نجاح"،
"توقيتamp“:”2016-0915T13:20:31Z”,
"معرف التتبع“:”f678d30879fd4adc25f2”,
"معرفات الرسائل":["1-4850879008"] }
فشل
HTTP/1.1 200 موافق
نوع المحتوى: application/json
طول المحتوى: 148
التاريخ: الخميس 15 سبتمبر 2016 13:20:31 بتوقيت جرينتش
{“responseCode”:1، “responseMessage”: “تسجيل دخول غير صالح أو استخدام غير مصرح به لواجهة برمجة التطبيقات”، “timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
نجاح
HTTP/1.1 200 موافق
نوع المحتوى: application/json
طول المحتوى: 144
التاريخ: الخميس 15 سبتمبر 2016 13:20:31 بتوقيت جرينتش
{“responseCode”:0،”responseMessage”:”نجاح”،”أحدث وقتamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
هذا هو نفس تنسيق JSON لسهولة القراءة:
{
"رمز الاستجابة":0,
"رسالة الرد":"نجاح"،
"توقيتamp“:”2016-0915T13:20:31Z”,
"معرف التتبع“:”f678d30879fd4adc25f2”,
"معرفات الرسائل":["1-4850879008"] }
فشل
HTTP/1.1 200 موافق
نوع المحتوى: application/json
طول المحتوى: 148
التاريخ: الخميس 15 سبتمبر 2016 13:20:31 بتوقيت جرينتش
{“responseCode”:1، “responseMessage”: “تسجيل دخول غير صالح أو استخدام غير مصرح به لواجهة برمجة التطبيقات”، “timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 رموز الاستجابة
من الممكن إرجاع رموز الاستجابة التالية في استجابة الإرسال:
| شفرة | نص | وصف |
| 0 | نجاح | تم التنفيذ بنجاح. |
| 1 | تسجيل دخول غير صالح أو استخدام API غير مصرح به | اسم المستخدم أو كلمة المرور غير الصحيحة أو سيتم حظر مقدم الخدمة بواسطة LINK Mobility. |
| 2 | تم حظر المستهلك بواسطة Link Mobility | تم حظر المستهلك بواسطة LINK Mobility. |
| 3 | لم يتم توفير التشغيل بواسطة LINK Mobility | تم حظر العملية بالنسبة لمزود الخدمة. |
| 4 | المستهلك غير معروف لشركة LINK Mobility | المستهلك غير معروف لشركة LINK Mobility. أو إذا تم استخدام الاسم المستعار في الطلب؛ لم يتم العثور على الاسم المستعار. |
| 5 | قام المستهلك بحظر هذه الخدمة في LINK Mobility | قام المستهلك بحظر هذه الخدمة في LINK Mobility. |
| 6 | العنوان الأصلي غير مدعوم | العنوان الأصلي غير مدعوم. |
| 7 | عنوان الأصل ألفا غير مدعوم بواسطة الحساب | عنوان الأصل ألفا غير مدعوم بواسطة الحساب. |
| 8 | عنوان MSISDN الأصلي غير مدعوم | عنوان المصدر MSISDN غير مدعوم. |
| 9 | لا يتم دعم GSM الممتد | لا يتم دعم GSM الممتد. |
| 10 | لا يتم دعم Unicode | لا يتم دعم Unicode. |
| 11 | تقرير الحالة غير مدعوم | لا يتم دعم تقرير الحالة. |
| 12 | القدرة المطلوبة غير مدعومة | لا يتم دعم القدرة المطلوبة (بخلاف المذكورة أعلاه) لإرسال الرسالة. |
| 13 | تم تجاوز الحد الأقصى لمعدل الخنق الذي حدده مزود المحتوى | يقوم مزود الخدمة بإرسال رسائل SMS إلى LINK Mobility بسرعة كبيرة. |
| 14 | معرف البروتوكول غير مدعوم بواسطة الحساب | معرف البروتوكول غير مدعوم. |
| 15 | تم تجاوز حد تسلسل الرسائل | عدد الرسائل المترابطة يتجاوز الحد الأقصى المطلوب. |
| 16 | غير قادر على توجيه الرسالة. | لم يتمكن LINK Mobility من توجيه الرسالة. |
| 17 | فترة زمنية محظورة | لا يجوز إرسال الرسائل خلال الفترة الزمنية |
| 18 | رصيد منخفض جدًا في حساب مزود الخدمة | تم حظر مزود الخدمة بسبب انخفاض الرصيد |
| 50 | نجاح جزئي | نجاح جزئي عند إرسال رسالة نصية قصيرة إلى عدة مستلمين. |
| 99 | خطأ في الخادم الداخلي | خطأ آخر في Link Mobility، اتصل بدعم LINK Mobility للحصول على مزيد من المعلومات. |
| 100 | عنوان الوجهة غير صالح | عنوان الوجهة (MSISDN، أو الاسم المستعار) غير صالح. |
| 102 | معرف مرجعي (مرتبط) غير صالح | معرف المرجع غير صالح، أو ربما تم استخدام معرف المرجع بالفعل، أو أنه قديم جدًا أو غير معروف. |
| 103 | اسم الحساب غير صالح | اسم الحساب غير صالح. |
| 105 | بيانات تعريف الخدمة غير صالحة | بيانات الخدمة التعريفية غير صالحة. |
| 106 | عنوان المصدر غير صالح | عنوان المصدر غير صالح. |
| 107 | عنوان المصدر الأبجدي الرقمي غير صالح | عنوان المصدر الأبجدي الرقمي غير صالح. |
| 108 | وقت صلاحية غير صالح | مدة الصلاحية غير صالحة. |
| 109 | وقت التسليم غير صالح | وقت التسليم غير صالح. |
| 110 | محتوى الرسالة/بيانات المستخدم غير صالحة | بيانات المستخدم، أي رسالة SMS، غير صالحة. |
| 111 | طول الرسالة غير صالح | طول الرسالة النصية القصيرة غير صالح. |
| 112 | رأس بيانات المستخدم غير صالح | رأس بيانات المستخدم غير صالح. |
| 113 | مخطط ترميز البيانات غير صالح | DCS غير صالح. |
| 114 | معرف بروتوكول غير صالح | معرف العملية غير صالح. |
| 115 | أعلام تقرير الحالة غير صالحة | علامات تقرير الحالة غير صالحة. |
| 116 | طن غير صالح | المصدر TON غير صالح. |
| 117 | ج غير صالحampاسم ign | جampاسم الموقع غير صالح. |
| 120 | حد غير صالح للحد الأقصى لعدد الرسائل المتسلسلة | الحد الأقصى لعدد الرسائل المترابطة غير صالح. |
| 121 | عنوان مصدر msisdn غير صالح | عنوان المصدر MSISDN غير صالح. |
| 122 | معرف الارتباط غير صالح | معرف الارتباط غير صالح. |
8. الميزات الاختيارية
8.1 تصحيح MSISDN
تصحيح MSISDN هي ميزة اختيارية يمكن تمكينها بواسطة دعم LINK Mobility عند الطلب.
ستقوم هذه الميزة بتصحيح عناوين الوجهة وتنسيقها وفقًا لتنسيق E.164 المطلوب. بالإضافة إلى تصحيح التنسيق، قد يقوم النظام أيضًا بأداء وظائف خاصة بالسوق مثل ترجمة الأرقام الفرنسية الدولية إلى أرقام DOM-TOM (الأقسام والأقاليم الخارجية) الصحيحة عند الاقتضاء.
فيما يلي عدد من الأمثلة السابقةampتصحيحات:
| عنوان الوجهة المرسل | عنوان الوجهة المصحح |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (الرقم الفرنسي مترجم إلى رقم DOM-TOM) |
بالإضافة إلى ذلك، من الممكن السماح بأرقام هواتف وطنية لسوق محددة. عند تمكين هذه الميزة، يجب إرسال أي أرقام دولية لأسواق أخرى بعلامة "+" أولية لتمييزها عن السوق المحددة.
فيما يلي العديد من الأمثلةampمجموعة من التصحيحات التي تم إجراؤها عند استخدام السويد (رمز الدولة 46) كسوق افتراضي للأرقام الوطنية.
| عنوان الوجهة المرسل | عنوان الوجهة المصحح |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | غير صالح لأن علامة "+" مفقودة |
يرجى ملاحظة أن MSISDN المصحح سيتم استخدامه بواسطة LINK Mobility وسيتم إرجاعه في تقارير التسليم.
يرجى الاتصال بدعم LINK Mobility للحصول على مزيد من المعلومات.
8.2 استبدال الأحرف
استبدال الأحرف هي ميزة اختيارية يمكن تمكينها من خلال دعم LINK Mobility عند الطلب.
ستقوم هذه الميزة بترجمة الأحرف الأبجدية غير التابعة لـ GSM في بيانات المستخدم (نص SMS) إلى أحرف أبجدية GSM مكافئة عندما يتم ضبط DCS على "GSM" (17). على سبيل المثالampستتم ترجمة "Seqüência de teste em Português" إلى "Seqüencia de teste em Portugues".
9. تقارير التسليم
يمكن لمزود الخدمة، إذا تم توفيره، طلب تقارير تسليم رسائل SMS أو إشعارات التسليم لرسائل MT المرسلة. يتم تشغيل هذه التقارير في SMSC للمشغل عندما يتم تسليم رسالة MT إلى المستهلك المستهدف أو حذفها، على سبيل المثال، منتهية الصلاحية أو، لسبب ما، غير قابلة للتوجيه.
يتم إبلاغ مزود الخدمة فقط بالحالة النهائية لرسالة SMS، أي تم تسليمها أو حذفها. يتم إنشاء تقرير واحد فقط لكل رسالة MT. مع حالة الحذف، قد يتم تطبيق رمز السبب. يحدد رمز السبب هذا سبب عدم تسليم رسالة SMS.
يتم توجيه التقارير عبر LINK Mobility وإرسالها إلى مزود الخدمة باستخدام بروتوكول HTTP.
لتلقي التقارير، يحتاج مزود الخدمة إلى التنفيذ على سبيل المثالampقم بإنشاء صفحة Java Servlet أو ASP.NET. يتلقى كلاهما طلبات HTTP GET أو POST.
حدود
يتضمن الطلب المعلمات التالية:
| المعلمة | يكتب | م/ع/أ* | القيمة الافتراضية | الطول الأقصى | وصف |
| معرف الرسالة | خيط | M | - | 22 | معرف الرسالة لرسالة MT التي يتوافق معها هذا التقرير. |
| عنوان الوجهة | خيط | M | - | 40 | MSISDN الخاص بالمستهلك، أي عنوان وجهة رسالة MT الأصلية. |
| كود الحالة | عدد صحيح | M | 1 | يشير رمز الحالة إلى حالة رسالة MT. رموز الحالة المعمول بها هي: 0 – تم التسليم 2 – تم الحذف (ينطبق رمز السبب) |
|
| الوقتamp | خيط | M | - | 20 | الوقت الذي يشير إلى موعد استلام تقرير التسليم بواسطة LINK Mobility. المنطقة الزمنية للوقت الحاليamp هو توقيت وسط أوروبا (CET) أو توقيت وسط أوروبا الصيفي (CEST) (حسب التوقيت الصيفي المحدد للاتحاد الأوروبي). التنسيق: yyyyMMdd HH:mm:ss. |
| المشغل | خيط | M | - | 100 | اسم المشغل المستخدم عند إرسال الرسالة النصية القصيرة أو اسم الحساب المستخدم عند إرسال الرسالة النصية القصيرة. يتم توفير قائمة المشغلين المتاحين من خلال دعم LINK Mobility. |
| رمز السبب | عدد صحيح | O | - | 3 | يشير رمز السبب إلى سبب وصول الرسالة إلى الحالة المحذوفة. رموز الأسباب القابلة للتطبيق هي: 100 – منتهية الصلاحية 101 – مرفوض 102 – خطأ في التنسيق 103- خطأ آخر 110 – المشترك غير معروف 111 – تم حظر المشترك 112 - لم يتم توفير المشترك 113 – المشترك غير متاح 120 – فشل SMSC 121 – ازدحام SMSC 122 – خدمة التجوال SMSC 130 – خطأ في الهاتف 131 – تجاوزت ذاكرة الهاتف قد يختلف السلوك مع تكاملات المشغل. |
| وقت المشغلamp | خيط | O | - | 20 | الوقت الذي يشير إلى وقت تشغيل التقرير في مركز SMSC الخاص بالمشغل (إذا تم توفيره من قبل المشغل). المنطقة الزمنية للوقت الحاليamp هو توقيت وسط أوروبا (CET) أو توقيت وسط أوروبا الصيفي (CEST) (حسب التوقيت الصيفي المحدد للاتحاد الأوروبي). التنسيق: yyyyMMdd HH:mm:ss. |
| حالة النص | خيط | O | - | 255 | عنصر نائب للحصول على معلومات إضافية من المشغل، على سبيل المثال وصف نصي واضح للحالة/السبب. قد يختلف السلوك مع تكاملات المشغل. |
| معرف الارتباط | خيط | O | - | 100 | معرف الارتباط المقدم في SendRequest أو SendTextRequest. |
| رمز شبكة المشغل | عدد صحيح | O | - | 6 | رمز شبكة الهاتف المحمول (MCC + MNC) للمشغل. |
* م = إلزامي، أو = اختياري، ط = متجاهل.
يتعين على مزود الخدمة أن يزود LINK Mobility بالهدف URL لتقارير التسليم (بما في ذلك اختياريًا بيانات اعتماد المصادقة الأساسية لـ HTTP). يمكن لمزود الخدمة اختيار طريقة HTTP المفضلة للاستخدام:
HTTP POST (مستحسن)
HTTP GET.
Exampباستخدام HTTP GET (تم التسليم بنجاح):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Exampاستخدم HTTP GET (لم يتم التسليم، لقد قدم المشغل الوقتamp للحدث):
المعلمات هي URL مُرمَّز.
ترميز الأحرف:
يمكن لمزود الخدمة اختيار ترميز الأحرف المفضل للاستخدام:
UTF-8 (مستحسن)
ISO-8859-1.
9.1 إقرار مقدم الخدمة
يجب على مزود الخدمة أن يقر بكل تقرير تسليم. يمكن أن يكون الإقرار إيجابيًا، أي تم استلام تقرير التسليم بنجاح، أو سلبيًا، أي فشل.
يرجى ملاحظة: يحتوي LINK Mobility على مهلة زمنية لقراءة الإقرارات لمدة 30 ثانية لتقارير التسليم. سيؤدي انتهاء المهلة الزمنية إلى إعادة محاولة التسليم (إذا تم تمكين إعادة المحاولة) أو إلغاء التسليم (إذا تم تعطيل إعادة المحاولة). وهذا يعني أن تطبيق مزود الخدمة يجب أن يضمن أوقات استجابة سريعة، خاصة أثناء التحميل المرتفع.
من المستحسن بشدة تأكيد تقرير التسليم تجاه LINK Mobility قبل معالجته.
يتم وصف قاعدة الإقرار الإيجابي والسلبي على النحو التالي:
الإقرار الإيجابي، الإقرار، تقرير التسليم المقدم:
رمز استجابة النطاق HTTP 200 مع المحتوى المنسق XML التالي:
الإقرار السلبي، NAK، تقرير التسليم لم يتم تسليمه:
أي رد بخلاف الإقرار الإيجابي، على سبيل المثالampفي هذه الحالة، يتم تشغيل الإقرار السلبي بواسطة أي رمز خطأ HTTP أو محتوى XML التالي:
يمكن استخدام محتوى XML للتحكم في آلية إعادة المحاولة الخاصة بـ LINK Mobility. سيؤدي NAK إلى إعادة المحاولة، إذا تم تمكينه. بالنسبة لموفري الخدمة غير المهيئين لآلية إعادة المحاولة، يكون محتوى XML اختياريًا.
فيما يلي طلب HTTP POST والاستجابة لهampنسخة من تقرير التسليم المقدم إلى مزود الخدمة:
طلب HTTP:
نشر /context/app HTTP/1.1
نوع المحتوى: application / x-www-form-urlمُرمَّز؛charset=utf-8
المضيف: الخادم: المنفذ
طول المحتوى: xx
معرف الرسالة=213123213&عنوان الوجهة=46762050312&المشغل=Telia&وقت المشغلamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
استجابة HTTP:
HTTP/1.1 200 موافق
نوع المحتوى: نص/عادي
9.2 إعادة المحاولة
يمكن لنظام LINK Mobility إجراء محاولات إعادة المحاولة لعمليات تسليم تقارير التسليم الفاشلة، أي التي لم يتم الاعتراف بها. يمكن لمزود الخدمة اختيار سلوك إعادة المحاولة المفضل:
لا إعادة المحاولة (افتراضي) - سيتم تجاهل الرسالة في حالة فشل محاولة الاتصال أو انتهاء مهلة القراءة أو في حالة وجود أي رمز خطأ HTTP.
إعادة المحاولة - سيتم إعادة إرسال الرسالة لكل نوع من مشاكل الاتصال، أو مهلة القراءة، أو الإقرار السلبي.
عند تمكين إعادة المحاولة لـ NAK، من المهم فهم السيناريوهات التي ستولد محاولة إعادة المحاولة من LINK Mobility وكيفية عمل إعادة المحاولة. كل مزود خدمة لديه قائمة إعادة المحاولة الخاصة به، حيث يتم ترتيب الرسائل وفقًا لوقت الرسالةampتحاول Link Mobility دائمًا تسليم الرسائل الأقدم أولاً، على الرغم من عدم ضمان ترتيب الرسائل الفردية التي يتم تسليمها إلى مزود الخدمة. والسبب الرئيسي لاستبعاد الرسائل من قائمة إعادة المحاولة هو أحد سببين: إما انتهاء صلاحية TTL للرسالة أو (نظريًا) امتلاء قائمة إعادة المحاولة. تعتمد TTL على المشغل والحساب، أي يمكن أن تختلف حسب المشغل و/أو نوع الرسالة، على سبيل المثال، رسالة SMS مميزة أو رسالة SMS بمعدل قياسي.
يجب على موفري الخدمة الذين قاموا بتمكين إعادة المحاولة التحقق من المعرف الفريد لرسالة MT للتأكد من أن الرسالة لم يتم استلامها بالفعل.
من المهم لمزود الخدمة الالتزام بهذه القواعد البسيطة عند حدوث خطأ أثناء معالجة تقرير التسليم إذا كان سبب الخطأ: مؤقتًا، مثل عدم توفر قاعدة البيانات، فيجب إرجاع NAK. سيعيد LINK Mobility إرسال الرسالة.
من المرجح أن تتسبب المحاولة الدائمة وإعادة المحاولة في نفس النوع من المشكلة، لذا يجب إرجاع إقرار. على سبيل المثالampعندما لا يمكن تحليل الرسالة بشكل صحيح أو تتسبب في حدوث خطأ غير متوقع في وقت التشغيل.
إن التصرف وفقًا لذلك سيضمن عدم التسبب في أي حظر أو انخفاض في الإنتاجية بسبب إعادة إرسال تقرير التسليم بشكل متكرر.
10. نصائح التنفيذ
1. من الممكن استخدامك web يتيح لك المتصفح إرسال الطلبات إلى واجهة برمجة التطبيقات. وهذا يجعل من السهل جدًا استكشاف الخدمات وتقييمها دون الحاجة إلى أي أدوات تطوير.
2. يوصى باستخدام Chrome أو Firefox مع ملحق مثل JSONView لعرض JSON بتنسيق جميل.
3. لقد استخدمنا SoapUI لاختبار POST والمصادقة الأساسية وفحص رسائل الطلب والاستجابة HTTP الخام.
4. جURL الأداة مفيدة لإرسال طلبات POST باستخدام المصادقة الأساسية. راجع المثالampأدناه.
curl بريد \
-H "نوع المحتوى: application/x-www-form-urlمُشفرة"
-H "التفويض: أساسي am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
–data “destinationAddress=46123456789&messageText=Hello+World%21”
_______________
تحويل الاتصالات الشخصية
المستندات / الموارد
 |
دليل تنفيذ LINK Mobility REST API SMS [بي دي اف] دليل المستخدم دليل تنفيذ التنقل REST API SMS، التنقل، دليل التنفيذ REST API SMS، REST API SMS، API SMS، SMS |
