SMS API, SMPP API MS Scheduler API
Пайдаланушы нұсқаулығы
SMS API, SMPP API MS Scheduler API
| Өзгертілген: | 6/24/2025 |
| Нұсқа: | 1.7 |
| Авторы: | Кенни Коландр Норден, KCN |
Бұл құжат тек тағайындалған алушыға арналған және артықшылықты, меншікті немесе басқа да жеке ақпаратты қамтуы мүмкін. Егер сіз оны қате алсаңыз, жіберушіге дереу хабарлаңыз және түпнұсқаны жойыңыз. Құжатты кез келген басқа пайдалануыңызға тыйым салынады.
Тарихты өзгерту
| Аян | Күн | By | Алдыңғы шығарылымдағы өзгерістер |
| 1.0 | 2010-03-16 | KCN | Құрылды |
| 1. | 2019-06-11 | TPE | Жаңартылған LINK логотиптері |
| 1. | 2019-09-27 | Pni | SMPP 3.4 спецификациясына сілтеме қосылды |
| 1. | 2019-10-31 | EP | Жарамдылық мерзімі туралы бақылау tag |
| 1. | 2020-08-28 | KCN | Қолдау көрсетілетін TLS нұсқаларына қатысты ақпарат қосылды |
| 2. | 2022-01-10 | KCN | Жеткізу есептеріне қатысты қосымша ақпарат қосылды TLS 1.3 туралы жаңартылған ақпарат |
| 2. | 2025-06-03 | GM | 2108 нәтиже коды қосылды |
| 2. | 2025-06-24 | AK | Квота қосылды |
Кіріспе
LINK Mobility 2001 жылдан бері SMS таратушы болып табылады және операторлармен де, қосылым агрегаторларымен де жұмыс істеуде үлкен тәжірибесі бар. Бұл платформа үлкен трафик көлемін өңдеуге, жоғары қолжетімділікті сақтауға және трафикті бірнеше қосылымдар арқылы бағыттауды жеңілдетуге арналған.
Бұл құжат SMSC-платформасының SMPP интерфейсін және қандай параметрлер мен пәрмендерді қажет ететінін және қандай параметрлерге қолдау көрсетілетінін сипаттайтын құжат.
Бұл құжат біріктірілген хабарлар, 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
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- деректерді_кодтау
- см_ұзындығы
- қысқа_хабарлама
Қолдау көрсетілмейтін параметрлер:
- қызмет_түрі
- protocol_id
- басымдық_жалауы
- кесте_жеткізу_уақыты
- егер_болған_жалауды ауыстырыңыз
- sm_default_msg_id
Ескерту бұл пайдалы жүктеме tag қолдау көрсетілмейді және бір қоңырауға тек бір SMS жеткізілуі мүмкін және жарамдылық_кезеңі ұсынылады tag кем дегенде 15 минуттық мәнге ие.
4.4.1 Ұсынылатын TON және NPI
Жіберу пәрменін пайдаланып хабарламаларды жіберу кезінде келесі TON және NPI қолданылуы керек.
4.4.1.1 Дереккөз
Бастапқы мекенжай үшін келесі TON және NPI комбинацияларына қолдау көрсетіледі. Барлық басқа комбинациялар жарамсыз деп есептеледі. Әдепкі TON from bind пәрмені TON параметрі Белгісіз (0) күйіне орнатылған болса, пайдаланылады. NPI Белгісіз (0) мәніне орнатылған болса, байланыстырудан әдепкі NPI пәрмені пайдаланылады.
| ТОН | NPI | Сипаттама |
| Әріптік-цифрлық (5) | Белгісіз (0) ISDN (1) |
Әріптік-сандық жіберуші мәтіні ретінде қарастырылады |
| Халықаралық (1) | Белгісіз (0) ISDN (1) |
MSISDN ретінде қарастырылады |
| Ұлттық (2) Желінің арнайы (3) абоненттік нөмірі (4) Қысқартылған (6) |
Белгісіз (0) ISDN (1) Ұлттық (8) |
Елге арнайы қысқа нөмір ретінде қарастырылады. |
4.4.1.2 Тағайындалған орын
Тағайындалған мекенжай үшін келесі TON және NPI комбинацияларына қолдау көрсетіледі. Барлық басқа комбинациялар жарамсыз деп есептеледі. Әдепкі TON from bind пәрмені TON параметрі Белгісіз (0) күйіне орнатылған болса, пайдаланылады. NPI Белгісіз (0) мәніне орнатылған болса, байланыстырудан әдепкі NPI пәрмені пайдаланылады.
| ТОН | NPI | Сипаттама |
| Халықаралық (1) | Белгісіз (0) ISDN (1) |
MSISDN ретінде қарастырылады |
4.4.2 Қолдау көрсетілетін кодтаулар
Келесі кодтауларға қолдау көрсетіледі. X кез келген мәнді қамтуы мүмкін.
| DCS | Кодтау |
| 0xX0 | Кеңейтімі бар әдепкі GSM әліпбиі |
| 0xX2 | 8-биттік екілік |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Квота
5.1 Квота асып кеттіview
Квота белгілі бір уақыт аралығында (күніне, аптасына, айына немесе белгісіз мерзімге) жіберуге болатын SMS хабарламаларының максималды санын анықтайды. Әрбір квота квота идентификаторы (UUID) арқылы бірегей түрде анықталады және тұтынушының уақыт белдеуіне сәйкес қайта орнатылады. Квоталарды Quota Pro арқылы елде, аймақта немесе әдепкі деңгейде тағайындауға боладыfile. Сондай-ақ квотаны Квота салыстыру арқылы динамикалық түрде тағайындауға болады. Бұл ата-аналық QuotaId (UUID) және бірегей квота кілтін (мысалы, жіберуші немесе пайдаланушы) белгілі бір квотаға сәйкестендіреді.
Квота жергілікті қолдауға, тағайындалған есептік жазба менеджеріне сәйкес немесе ештеңе көрсетілмесе, әдепкі бойынша орнатылады.
5.2 Күй 106 – Квота асып кетті
SMS-хабарлама келесі жағдайларда 106 күй коды («квотадан асып кетті») арқылы бұғатталуы мүмкін:
- Хабарлама ағымдағы аралықтағы сәйкес квотаны анықтау шегінен асып түседі.
- Тағайындалған елге немесе аймаққа квота тағайындалмаған (яғни, профессионалды бағдарламада нөлдік квотаны салыстыру арқылы анық блокталған.file).
- Сәйкес квота жоқ және әдепкі квота анықталмаған, нәтижесінде бас тарту.
Мұндай жағдайларда жүйе тұтынушыға немесе тағайындалған жерге негізделген шектеулерді орындау және дұрыс пайдаланбау үшін хабарламаны одан әрі өңдеуге жол бермейді.
Жеткізу туралы есеп
Тек ешқайсысы немесе сәтті/сәтсіз нәтижесі бар соңғы жеткізуге қолдау көрсетіледі.
Жеткізу туралы есеп пішімі: идентификатор: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx орындалған күні: yyMMddHHmm stat:
Күйдегі қолжетімді мәндер:
- ЖЕТКІЗУ
- МЕРЗІМІ ӨТКЕН
- ҚАБЫЛДАУD
- ЖЕТКІЗУ
- ЖОЮ
6.1 Кеңейтілген жеткізу есебі пішімі
Жеткізу есептеріндегі кеңейтілген ақпарат сату өкілімен байланыста сұралуы мүмкін.
Жеткізу туралы есеп пішімі: идентификатор: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 жіберу күні:
yyMMddHHmm орындалған күні: yyMMddHHmm статистика: қате: мәтін:
Күйдегі қолжетімді мәндер:
- ЖЕТКІЗУ
- МЕРЗІМІ ӨТКЕН
- ҚАБЫЛДАУD
- ЖЕТКІЗУ
- ЖОЮ
«sub» және «dlvrd» өрістері әрқашан 000 мәніне орнатылады, ал «мәтін» өрісі әрқашан бос болады.
«Қате» өрісінің мәндерін Қате кодтары тарауын қараңыз.
Қолдау көрсетілетін TLS нұсқалары
TLS 1.2 немесе TLS 1.3 SMPP арқылы барлық TLS қосылымдары үшін қажет.
TLS 1.0 және 1.1 қолдауы 2020-11-15 бастап тоқтатылды. TLS 1.0 және 1.1 нұсқалары ескірген протоколдар болып табылады және Интернет қауымдастығында қауіпсіздік тәуекелдері ретінде қарастырылады.
Егер шифрланбаған SMPP қосылымдары бүгін қолданылса, LINK TLS пайдалануды ұсынады. Шифрланбаған SMPP қосылымдары LINK арқылы 2020-09-01 күні ескірген және болашақта жойылады. Шифрланбаған қосылымдарды жою күні әлі анықталған жоқ.
TLS үшін SMPP серверіне қосылымдар 3601 портында шифрланбағанның орнына 3600 портында болады.
Сіз әлі де TLS пайдалана аласыз, тіпті SMPP енгізуіңіз stunnel көмегімен TLS қолданбасын, қараңыз 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 Scheduler API [pdf] Пайдаланушы нұсқаулығы SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |