SMS API، SMPP API MS جدولة API
دليل المستخدم
SMS API، SMPP API MS جدولة API
| معدل: | 6/24/2025 |
| إصدار: | 1.7 |
| مؤلف: | كيني كولاندر نوردن، KCN |
هذا المستند مخصص للمستلم المعين فقط وقد يحتوي على معلومات مميزة أو مملوكة أو معلومات خاصة. إذا كنت قد استلمتها عن طريق الخطأ، فيرجى إبلاغ المرسل فورًا وحذف الأصل. يحظر أي استخدام آخر للوثيقة من قبلك.
تغيير التاريخ
| القس | تاريخ | By | التغييرات من الإصدار السابق |
| 1.0 | 2010-03-16 | كيه سي إن | مخلوق |
| 1. | 2019-06-11 | مادة تي بي إي | تحديث شعارات الارتباط |
| 1. | 2019-09-27 | PNI | تمت إضافة إشارة إلى مواصفات SMPP 3.4 |
| 1. | 2019-10-31 | EP | ملاحظة حول مدة الصلاحية tag |
| 1. | 2020-08-28 | كيه سي إن | تمت إضافة معلومات بخصوص إصدارات TLS المدعومة |
| 2. | 2022-01-10 | كيه سي إن | تمت إضافة معلومات إضافية بخصوص تقارير التسليم معلومات محدثة بخصوص TLS 1.3 |
| 2. | 2025-06-03 | GM | تمت إضافة رمز النتيجة 2108 |
| 2. | 2025-06-24 | AK | تمت إضافة الحصة |
مقدمة
تعمل LINK Mobility كموزع للرسائل النصية القصيرة منذ عام 2001 وتتمتع بخبرة كبيرة في العمل مع كل من المشغلين ومجمعي الاتصالات. تم تصميم هذا النظام الأساسي للتعامل مع أحجام حركة المرور الكبيرة والحفاظ على التوفر العالي وتسهيل توجيه حركة المرور عبر اتصالات متعددة.
تصف هذه الوثيقة واجهة SMPP لمنصة SMSC والمعلمات والأوامر المطلوبة والمعلمات المدعومة.
لن تتناول هذه الوثيقة حالات استخدام محددة مثل الرسائل المتسلسلة، وWAPpush، وFlash SMS، وما إلى ذلك. يمكن الحصول على مزيد من المعلومات حول هذه الحالات من خلال الاتصال بالدعم.
الأوامر المدعومة
يجب التعامل مع خادم LINK Mobility على أنه SMPP 3.4. المواصفات الرسمية يمكن العثور عليها في https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
كافة الطرق غير مدعومة، ويتم تحديد كافة الاختلافات أدناه.
4.1 ربط
يتم دعم أوامر الربط التالية.
- جهاز الإرسال
- جهاز الإرسال والاستقبال
- المتلقي
المعلمات المطلوبة:
- system_id - تم الحصول عليه من الدعم
- كلمة المرور - تم الحصول عليها من الدعم
معلمات اختيارية:
- addr_ton – القيمة الافتراضية إذا تم تعيين TON على غير معروف أثناء الإرسال.
- addr_npi - القيمة الافتراضية إذا تم تعيين NPI على غير معروف أثناء الإرسال.
المعلمات غير المدعومة:
- عنوان_نطاق
4.2 فك الارتباط
أمر إلغاء الربط مدعوم.
4.3 رابط الاستفسار
إن أمر رابط الاستعلام مدعوم ويجب استدعاؤه كل 60 ثانية.
4.4 إرسال
يجب استخدام طريقة الإرسال لتسليم الرسائل.
المعلمات المطلوبة:
- source_addr_ton
- source_addr_npi
- المصدر_العنوان
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- تشفير البيانات
- sm_length
- short_message
المعلمات غير المدعومة:
- نوع الخدمة
- Protocol_id
- Priority_flag
- schedule_delivery_time
- استبدال_if_present_flag
- sm_default_msg_id
ملحوظة أن الحمولة tag غير مدعوم وقد يتم تسليم رسالة قصيرة واحدة فقط لكل مكالمة ويوصى بفترة الصلاحية tag تبلغ قيمته 15 دقيقة على الأقل.
4.4.1 الموصى بها TON وNPI
يجب استخدام TON وNPI التاليين عند إرسال الرسائل باستخدام أمر الإرسال.
4.4.1.1 المصدر
تركيبات TON وNPI التالية مدعومة لعناوين المصدر. جميع التركيبات الأخرى غير صالحة. سيتم استخدام أمر TON الافتراضي من bind إذا تم ضبط TON على غير معروف (0). سيتم استخدام أمر NPI الافتراضي من bind إذا تم ضبط NPI على غير معروف (0).
| طن | رقم الإيداع الوطني | وصف |
| أبجدي رقمي (5) | غير معروف (0) الشبكة الرقمية للخدمات المتكاملة (1) |
سيتم التعامل معه كنص أبجدي رقمي للمرسل |
| دولي (1) | غير معروف (0) الشبكة الرقمية للخدمات المتكاملة (1) |
سيتم التعامل معه على أنه MSISDN |
| وطني (2) الشبكة المحددة (3) رقم المشترك (4) مختصر (6) |
غير معروف (0) الشبكة الرقمية للخدمات المتكاملة (1) وطني (8) |
سيتم التعامل معه كرقم قصير خاص بكل بلد. |
4.4.1.2 الوجهة
مجموعات TON وNPI التالية مدعومة لعنوان الوجهة. سيتم التعامل مع جميع المجموعات الأخرى على أنها غير صالحة. سيتم استخدام الأمر TON الافتراضي من bind إذا تم تعيين TON على غير معروف (0). سيتم استخدام أمر NPI الافتراضي من الربط إذا تم تعيين NPI على غير معروف (0).
| طن | رقم الإيداع الوطني | وصف |
| دولي (1) | غير معروف (0) الشبكة الرقمية للخدمات المتكاملة (1) |
سيتم التعامل معه على أنه MSISDN |
4.4.2 الترميزات المدعومة
الترميزات التالية مدعومة. قد يحتوي X على أي قيمة.
| دي سي إس | الترميز |
| 0xX0 | الأبجدية GSM الافتراضية مع الامتداد |
| 0xX2 | 8 بت ثنائي |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
الحصة
5.1 تجاوز الحصةview
تُحدد الحصة الحد الأقصى لعدد رسائل SMS التي يُمكن إرسالها خلال فترة زمنية مُحددة (مثلاً، يوميًا، أو أسبوعيًا، أو شهريًا، أو بشكل غير مُحدد). تُعرف كل حصة بمعرف فريد (UUID) ويُعاد ضبطها وفقًا للمنطقة الزمنية للعميل. يُمكن تخصيص الحصص على مستوى البلد، أو المنطقة، أو على المستوى الافتراضي من خلال برنامج "حصة احترافية".fileيمكن أيضًا تعيين الحصة ديناميكيًا باستخدام تعيين الحصة. يُربط هذا بمعرف الحصة الرئيسي (UUID) ومفتاح الحصة الفريد (مثل المُرسِل أو المستخدم) إلى معرف حصة مُحدد.
يتم تعيين الحصة وفقًا للدعم المحلي لديك أو مدير الحساب المخصص لك أو بشكل افتراضي إذا لم يتم تحديد أي شيء.
5.2 الحالة 106 - تم تجاوز الحصة
قد يتم حظر رسالة SMS برمز الحالة 106 ("تم تجاوز الحصة") عندما:
- تتجاوز الرسالة الحد المحدد لمعرف الحصة المقابل لها ضمن الفاصل الزمني الحالي.
- لا يتم تعيين حصة للبلد أو المنطقة الوجهة (أي يتم حظرها صراحةً باستخدام تعيين حصة فارغة في البرنامج)file).
- لا يوجد حصة مطابقة ولم يتم تعريف حصة افتراضية، مما يؤدي إلى الرفض.
في هذه الحالات، يمنع النظام معالجة الرسائل الإضافية لفرض حدود تعتمد على العميل أو الوجهة وتجنب سوء الاستخدام.
إشعار بالإستلام
لا يتم دعم سوى التسليم النهائي أو عدم وجود نتيجة ناجحة/فاشلة.
التنسيق في تقرير التسليم: المعرف: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx تاريخ الانتهاء: yyMMddHHmm stat:
القيم المتوفرة في الحالة:
- تم التسليم
- منتهي الصلاحية
- مرفوض
- لم يتم التسليم
- تم الحذف
6.1 تنسيق تقرير التسليم الممتد
قد يتم طلب معلومات موسعة في تقارير التسليم عند الاتصال بمندوب المبيعات الخاص بك.
تنسيق تقرير التسليم: المعرف: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx الفرعي: 000 dlvrd: 000 تاريخ الإرسال:
yyMMddHHmm تاريخ الانتهاء: yyMMddHHmm stat: خطأ: نص:
القيم المتوفرة في الحالة:
- تم التسليم
- منتهي الصلاحية
- مرفوض
- لم يتم التسليم
- تم الحذف
سيتم تعيين الحقلين "sub" و"dlvrd" دائمًا على 000، وسيكون الحقل "text" فارغًا دائمًا.
راجع الفصل رموز الخطأ لمعرفة قيم الحقل "يخطئ".
إصدارات TLS المدعومة
TLS 1.2 أو TLS 1.3 مطلوب لجميع اتصالات TLS عبر SMPP.
تم إيقاف دعم TLS 1.0 و1.1 منذ 2020-11-15. يعد الإصداران 1.0 و1.1 من TLS من البروتوكولات الأقدم التي تم إهمالها وتعتبر بمثابة مخاطر أمنية في مجتمع الإنترنت.
يوصي LINK بشدة باستخدام TLS في حالة استخدام اتصالات SMPP غير المشفرة اليوم. تم إهمال اتصالات SMPP غير المشفرة اعتبارًا من 2020-09-01 بواسطة LINK، وستتم إزالتها في المستقبل. لم يتم تحديد موعد إزالة الاتصالات غير المشفرة بعد.
الاتصالات نحو خادم SMPP لـ TLS تكون على المنفذ 3601 بدلاً من أن تكون غير مشفرة على المنفذ 3600.
لا يزال بإمكانك استخدام TLS حتى إذا كان تطبيق SMPP الخاص بك لا يدعم TLS باستخدام Stunnel، راجع https://www.stunnel.org/
رموز الخطأ
قد يتم الرد على رموز الخطأ التالية في حقل الخطأ إذا تم تمكين الحقل.
| رمز الخطأ | وصف |
| 0 | خطأ غير معروف |
| 1 | خطأ توجيه مؤقت |
| 2 | خطأ توجيه دائم |
| 3 | تم تجاوز الحد الأقصى للاختناق |
| 4 | نفذ الوقت |
| 5 | خطأ غير معروف للمشغل |
| 6 | خطأ المشغل |
| 100 | لم يتم العثور على الخدمة |
| 101 | لم يتم العثور على المستخدم |
| 102 | الحساب غير موجود |
| 103 | رمز مرور خاطئ |
| 104 | خطأ في التكوين |
| 105 | خطأ داخلي |
| 106 | تم تجاوز الحصة |
| 200 | OK |
| 1000 | مرسل |
| 1001 | تم التوصيل |
| 1002 | منتهي الصلاحية |
| 1003 | تم الحذف |
| 1004 | الجوال ممتلئ |
| 1005 | في قائمة الانتظار |
| 1006 | لم يتم التسليم |
| 1007 | تم التسليم، وتأخرت الرسوم |
| 1008 | تم الشحن، ولم يتم إرسال الرسالة |
| 1009 | تم الشحن، ولم يتم تسليم الرسالة |
| 1010 | منتهية الصلاحية، عدم وجود تقرير تسليم المشغل |
| 1011 | تم الشحن، تم إرسال الرسالة (إلى المشغل) |
| 1012 | في قائمة الانتظار عن بعد |
| 1013 | تم إرسال الرسالة إلى المشغل، تأخر الشحن |
| 2000 | رقم المصدر غير صالح |
| 2001 | الرقم القصير غير معتمد كمصدر |
| 2002 | ألفا غير معتمد كمصدر |
| 2003 | MSISDN غير مدعوم كرقم مصدر |
| 2100 | الرقم القصير غير معتمد كوجهة |
| 2101 | ألفا غير معتمد كوجهة |
| 2102 | MSISDN غير مدعوم كوجهة |
| 2103 | تم حظر العملية |
| 2104 | مشترك غير معلوم |
| 2105 | تم حظر الوجهة |
| 2106 | خطأ في الرقم |
| 2107 | الوجهة محظورة مؤقتًا |
| 2108 | وجهة غير صالحة |
| 2200 | خطأ الشحن |
| 2201 | المشترك لديه رصيد منخفض |
|
2202 |
تم حظر المشترك بسبب زيادة الرسوم (المميز)
رسائل |
|
2203 |
المشترك صغير جدًا (بالنسبة لهذه الحالة على وجه الخصوص
المحتوى) |
| 2204 | غير مسموح لمشتركي الدفع المسبق |
| 2205 | الخدمة مرفوضة من قبل المشترك |
| 2206 | المشترك غير مسجل في نظام الدفع |
| 2207 | لقد وصل المشترك إلى الحد الأقصى للرصيد |
| 2208 | يلزم تأكيد المستخدم النهائي |
| 2300 | تم استرداد المبلغ |
|
2301 |
لم نتمكن من استرداد المبلغ بسبب خطأ غير قانوني أو مفقود
رقم MSISDN |
| 2302 | لا يمكن استرداد الأموال بسبب فقدان معرف الرسالة |
| 2303 | في قائمة الانتظار لاسترداد الأموال |
| 2304 | مهلة استرداد |
| 2305 | فشل استرداد الأموال |
| 3000 | ترميز GSM غير مدعوم |
| 3001 | ترميز UCS2 غير مدعوم |
| 3002 | الترميز الثنائي غير مدعوم |
| 4000 | تقرير التسليم غير معتمد |
| 4001 | محتوى الرسالة غير صالح |
| 4002 | تعريفة غير صالحة |
| 4003 | بيانات المستخدم غير صالحة |
| 4004 | رأس بيانات المستخدم غير صالح |
| 4005 | ترميز البيانات غير صالح |
| 4006 | ضريبة القيمة المضافة غير صالحة |
| 4007 | محتوى غير معتمد للوجهة |
المستندات / الموارد
 |
ربط التنقل SMS API، SMPP API MS جدولة API [بي دي اف] دليل المستخدم SMS API SMPP API MS جدولة API، SMS API SMPP API، MS جدولة API، جدولة API، API |