SMS API, SMPP API MS Scheduler API
Foydalanuvchi uchun qoʻllanma
SMS API, SMPP API MS Scheduler API
| O'zgartirilgan: | 6/24/2025 |
| Versiya: | 1.7 |
| Muallif: | Kenny Colander Norden, KCN |
Ushbu hujjat faqat tayinlangan oluvchi uchun mo'ljallangan va u imtiyozli, mulkiy yoki boshqa shaxsiy ma'lumotlarni o'z ichiga olishi mumkin. Agar siz uni xatolik bilan olgan bo'lsangiz, darhol jo'natuvchiga xabar bering va asl nusxasini o'chirib tashlang. Hujjatdan boshqa har qanday foydalanish taqiqlanadi.
Tarixni o'zgartirish
| Rev | Sana | By | Oldingi versiyadagi o'zgarishlar |
| 1.0 | 2010-03-16 | KCN | Yaratilgan |
| 1. | 2019-06-11 | TPE | LINK logotiplari yangilandi |
| 1. | 2019-09-27 | PNI | SMPP 3.4 spetsifikatsiyasiga havola qo'shildi |
| 1. | 2019-10-31 | EP | Amal qilish muddati haqida kuzatish tag |
| 1. | 2020-08-28 | KCN | Qo'llab-quvvatlanadigan TLS versiyalari haqida ma'lumot qo'shildi |
| 2. | 2022-01-10 | KCN | Yetkazib berish hisobotlari bo'yicha qo'shimcha ma'lumotlar qo'shildi TLS 1.3 haqida yangilangan ma'lumotlar |
| 2. | 2025-06-03 | GM | 2108 natija kodi qo'shildi |
| 2. | 2025-06-24 | AK | Kvota qo'shildi |
Kirish
LINK Mobility 2001 yildan buyon SMS tarqatuvchi hisoblanadi va operatorlar va ulanish agregatorlari bilan ishlashda katta tajribaga ega. Ushbu platforma katta trafik hajmlarini boshqarish, yuqori mavjudlikni saqlash va trafikni bir nechta ulanishlar orqali yo'naltirishni osonlashtirish uchun mo'ljallangan.
Bu hujjat SMSC-platformaga SMPP interfeysi va qaysi parametrlar va buyruqlar talab qilinishi va qaysi parametrlar qo'llab-quvvatlanishini tavsiflaydi.
Ushbu hujjat birlashtirilgan xabarlar, WAPpush, Flash SMS va boshqalar kabi maxsus foydalanish holatlarini ko'rib chiqmaydi. Bunday holatlar haqida batafsil ma'lumotni qo'llab-quvvatlash xizmatiga murojaat qilish orqali olish mumkin.
Qo'llab-quvvatlanadigan buyruqlar
LINK Mobility serveriga SMPP 3.4 sifatida qarash kerak. Rasmiy spetsifikatsiyani quyidagi manzilda topish mumkin https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Barcha usullar qo'llab-quvvatlanmaydi va barcha farqlar quyida ko'rsatilgan.
4.1 Bog'lash
Quyidagi bog'lash buyruqlari qo'llab-quvvatlanadi.
- Transmitter
- Transsiver
- Qabul qiluvchi
Kerakli parametrlar:
- system_id - qo'llab-quvvatlashdan olingan
- parol - qo'llab-quvvatlashdan olingan
Ixtiyoriy parametrlar:
- addr_ton - agar yuborish paytida TON Noma'lum bo'lsa, standart qiymat.
- addr_npi – agar yuborish vaqtida NPI Noma’lum bo‘lsa, standart qiymat.
Qo'llab-quvvatlanmaydigan parametrlar:
- manzil_oraliq
4.2 Bog'lash
Ochish buyrug'i qo'llab-quvvatlanadi.
4.3 So'rov havolasi
Inquire link buyrug'i qo'llab-quvvatlanadi va har 60 soniyada qo'ng'iroq qilish kerak.
4.4 Yuborish
Xabarlarni yuborish uchun yuborish usulidan foydalanish kerak.
Kerakli parametrlar:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- ma'lumotlarni_kodlash
- sm_uzunligi
- qisqa_xabar
Qo'llab-quvvatlanmaydigan parametrlar:
- xizmat_turi
- protokol_id
- ustuvor_bayroq
- jadval_etkazib berish_vaqti
- agar_mavjud_bayroqni almashtiring
- sm_default_msg_id
Eslatma bu foydali yuk tag qo'llab-quvvatlanmaydi va har bir qo'ng'iroq uchun faqat bitta SMS yuborilishi mumkin va amal qilish muddatini belgilash tavsiya etiladi tag kamida 15 daqiqa davom etadigan qiymatga ega.
4.4.1 Tavsiya etilgan TON va NPI
Submit buyrug'i yordamida xabarlarni jo'natishda quyidagi TON va NPI dan foydalanish kerak.
4.4.1.1 Manba
Quyidagi TON va NPI kombinatsiyalari manba manzili uchun qo'llab-quvvatlanadi. Boshqa barcha kombinatsiyalar yaroqsiz deb hisoblanadi. Agar TON Noma'lum (0) ga o'rnatilgan bo'lsa, standart TON from bind buyrug'i ishlatiladi. Agar NPI Noma'lum (0) ga o'rnatilgan bo'lsa, ulanish buyrug'idan standart NPI ishlatiladi.
| TON | NPI | Tavsif |
| Alfanumerik (5) | Noma'lum (0) ISDN (1) |
Alfanumerik yuboruvchi matni sifatida qabul qilinadi |
| Xalqaro (1) | Noma'lum (0) ISDN (1) |
MSISDN sifatida qabul qilinadi |
| Milliy (2) Tarmoqqa xos (3) abonent raqami (4) Qisqartirilgan (6) |
Noma'lum (0) ISDN (1) Milliy (8) |
Mamlakatga xos qisqa raqam sifatida ko'rib chiqiladi. |
4.4.1.2 Belgilangan manzil
Belgilangan manzil uchun quyidagi TON va NPI kombinatsiyalari qo'llab-quvvatlanadi. Boshqa barcha kombinatsiyalar yaroqsiz deb hisoblanadi. Agar TON Noma'lum (0) ga o'rnatilgan bo'lsa, standart TON from bind buyrug'i ishlatiladi. Agar NPI Noma'lum (0) ga o'rnatilgan bo'lsa, ulanish buyrug'idan standart NPI ishlatiladi.
| TON | NPI | Tavsif |
| Xalqaro (1) | Noma'lum (0) ISDN (1) |
MSISDN sifatida qabul qilinadi |
4.4.2 Qo'llab-quvvatlanadigan kodlashlar
Quyidagi kodlashlar qo'llab-quvvatlanadi. X har qanday qiymatni o'z ichiga olishi mumkin.
| DCS | Kodlash |
| 0xX0 | Kengaytmali standart GSM alifbosi |
| 0xX2 | 8 bitli ikkilik |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Kvota tugadiview
Kvota ma'lum vaqt oralig'ida (masalan, kun, hafta, oy yoki muddatsiz) yuborilishi mumkin bo'lgan SMS xabarlarning maksimal sonini belgilaydi. Har bir kvota quotaId (UUID) bilan noyob tarzda aniqlanadi va mijozning vaqt zonasiga ko'ra qayta o'rnatiladi. Kvotalar mamlakat, mintaqa yoki standart darajada Quota Pro orqali tayinlanishi mumkinfile. Kvotani Kvota xaritasi yordamida dinamik ravishda belgilash ham mumkin. Bu ota-ona QuotaId (UUID) va noyob kvota kalitini (masalan, jo'natuvchi yoki foydalanuvchi) ma'lum bir kvotaIdga moslashtiradi.
Kvota mahalliy qo'llab-quvvatlash, tayinlangan hisob menejeri yoki hech narsa belgilanmagan bo'lsa, sukut bo'yicha o'rnatiladi.
5.2 Status 106 – Kvotadan oshib ketdi
SMS-xabar 106 holat kodi bilan bloklanishi mumkin (“kvota oshib ketdi”):
- Xabar joriy oraliqda tegishli kvotasi uchun belgilangan chegaradan oshib ketdi.
- Belgilangan mamlakat yoki mintaqaga kvota tayinlanmagan (ya'ni, proda nol kvota xaritasi bilan aniq bloklangan)file).
- Mos kvota yo'q va standart kvota belgilanmagan, natijada rad etish.
Bunday hollarda, tizim mijoz yoki manzilga asoslangan chegaralarni qo'llash va noto'g'ri foydalanishni oldini olish uchun xabarlarni keyingi qayta ishlashni oldini oladi.
Yetkazib berish hisoboti
Muvaffaqiyatli/muvaffaqiyatsiz natija bilan faqat hech biri yoki yakuniy yetkazib berish qo'llab-quvvatlanadi.
Yetkazib berish hisoboti formati: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx bajarilgan sana: yyMMddHHmm stat:
Holatdagi mavjud qiymatlar:
- Etkazib berish
- MUDDATI O'TGAN
- RAD ETD
- QAYTA QILMAGAN
- OʻCHIRILGAN
6.1 Kengaytirilgan yetkazib berish hisoboti formati
Yetkazib berish hisobotlaridagi kengaytirilgan ma'lumot sizning savdo vakilingiz bilan bog'lanishda so'ralishi mumkin.
Yetkazib berish hisoboti formati: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 topshirish sanasi:
yyMMddHHmm bajarilgan sana: yyMMddHHmm statistika: xato: matn:
Holatdagi mavjud qiymatlar:
- Etkazib berish
- MUDDATI O'TGAN
- RAD ETD
- QAYTA QILMAGAN
- OʻCHIRILGAN
"sub" va "dlvrd" maydonlari har doim 000 ga o'rnatiladi va "matn" maydoni doimo bo'sh bo'ladi.
“Xato” maydonining qiymatlari uchun “Xato kodlari” bo‘limiga qarang.
Qo'llab-quvvatlanadigan TLS versiyalari
SMPP orqali barcha TLS ulanishlari uchun TLS 1.2 yoki TLS 1.3 talab qilinadi.
TLS 1.0 va 1.1-ni qo‘llab-quvvatlash 2020-11-15 dan boshlab to‘xtatildi. TLS ning 1.0 va 1.1 versiyalari eskirgan protokollar boʻlib, Internet hamjamiyatida xavfsizlikka xavf tugʻdiradi.
Agar bugungi kunda shifrlanmagan SMPP ulanishlari ishlatilayotgan bo'lsa, LINK TLS dan foydalanishni qat'iy tavsiya qiladi. Shifrlanmagan SMPP ulanishlari LINK tomonidan 2020-09-01 holatiga ko‘ra eskirgan va kelajakda o‘chirib tashlanadi. Shifrlanmagan ulanishlarni olib tashlash sanasi hali aniqlanmagan.
TLS uchun SMPP serveriga ulanishlar 3601-portda shifrlanmagan o'rniga 3600-portda.
SMPP ilovangiz stunnel yordamida TLSni qoʻllab-quvvatlamasa ham, siz hali ham TLS dan foydalanishingiz mumkin, qarang https://www.stunnel.org/
Xato kodlari
Agar maydon yoqilgan bo'lsa, xato maydoniga quyidagi xato kodlari javob berishi mumkin.
| Xato kodi | Tavsif |
| 0 | Noma'lum xato |
| 1 | Vaqtinchalik marshrutlash xatosi |
| 2 | Doimiy marshrutlash xatosi |
| 3 | Maksimal regulyatordan oshib ketdi |
| 4 | Taym-aut; turib qolish; tanaffus |
| 5 | Operator noma'lum xato |
| 6 | Operator xatosi |
| 100 | Xizmat topilmadi |
| 101 | Foydalanuvchi topilmadi |
| 102 | Hisob topilmadi |
| 103 | Yaroqsiz parol |
| 104 | Konfiguratsiya xatosi |
| 105 | Ichki xato |
| 106 | Kvota oshib ketdi |
| 200 | OK |
| 1000 | Yuborildi |
| 1001 | Yetkazib berildi |
| 1002 | Muddati tugagan |
| 1003 | Oʻchirildi |
| 1004 | Mobil to'liq |
| 1005 | Navbatda |
| 1006 | Yetkazib berilmagan |
| 1007 | Yetkazib berildi, toʻlov kechiktirildi |
| 1008 | Zaryadlangan, xabar yuborilmadi |
| 1009 | Zaryadlangan, xabar yetkazilmadi |
| 1010 | Muddati tugagan, operator yetkazib berish hisobotining yo'qligi |
| 1011 | Zaryadlangan, xabar yuborilgan (operatorga) |
| 1012 | Masofadan navbatga qoʻyilgan |
| 1013 | Operatorga xabar yuborildi, zaryadlash kechiktirildi |
| 2000 | Manba raqami noto‘g‘ri |
| 2001 | Qisqa raqam manba sifatida qo'llab-quvvatlanmaydi |
| 2002 | Alpha manba sifatida qo'llab-quvvatlanmaydi |
| 2003 | MSISDN manba raqami sifatida qo'llab-quvvatlanmaydi |
| 2100 | Qisqa raqam manzil sifatida qo‘llab-quvvatlanmaydi |
| 2101 | Alpha manzil sifatida qo‘llab-quvvatlanmaydi |
| 2102 | MSISDN manzil sifatida qo‘llab-quvvatlanmaydi |
| 2103 | Operatsiya bloklandi |
| 2104 | Noma'lum obunachi |
| 2105 | Manzil bloklandi |
| 2106 | Raqam xatosi |
| 2107 | Manzil vaqtincha bloklangan |
| 2108 | Belgilangan manzil noto‘g‘ri |
| 2200 | Zaryadlash xatosi |
| 2201 | Abonent balansi past |
|
2202 |
Abonent ortiqcha toʻlov uchun taqiqlangan (premium)
xabarlar |
|
2203 |
Abonent juda yosh (bu uchun
tarkib) |
| 2204 | Prepaid abonentiga ruxsat berilmagan |
| 2205 | Xizmat abonent tomonidan rad etilgan |
| 2206 | Abonent to'lov tizimida ro'yxatdan o'tmagan |
| 2207 | Abonent maksimal balansga yetdi |
| 2208 | Yakuniy foydalanuvchi tasdiqlashi kerak |
| 2300 | Toʻlov qaytarildi |
|
2301 |
Noqonuniy yoki etishmayotganligi sababli toʻlovni qaytarib boʻlmadi
MSISDN |
| 2302 | Xabar identifikatori yoʻqligi sababli toʻlovni qaytarib boʻlmadi |
| 2303 | Toʻlovni qaytarish uchun navbatga qoʻyilgan |
| 2304 | Pulni qaytarish muddati tugaydi |
| 2305 | Toʻlovni qaytarish muvaffaqiyatsiz tugadi |
| 3000 | GSM kodlash qo'llab-quvvatlanmaydi |
| 3001 | UCS2 kodlash qo'llab-quvvatlanmaydi |
| 3002 | Ikkilik kodlash qo'llab-quvvatlanmaydi |
| 4000 | Yetkazib berish hisoboti qo'llab-quvvatlanmaydi |
| 4001 | Xabar mazmuni noto‘g‘ri |
| 4002 | Yaroqsiz tarif |
| 4003 | Foydalanuvchi maʼlumotlari notoʻgʻri |
| 4004 | Foydalanuvchi maʼlumotlari sarlavhasi notoʻgʻri |
| 4005 | Maʼlumotlarni kodlash notoʻgʻri |
| 4006 | Yaroqsiz QQS |
| 4007 | Belgilangan manzil uchun qo‘llab-quvvatlanmaydigan kontent |
Hujjatlar / manbalar
 |
havola mobilligi SMS API, SMPP API MS Scheduler API [pdf] Foydalanuvchi uchun qoʻllanma SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |