SMS API, SMPP API API MS Scheduler
Дастури корбар
SMS API, SMPP API API MS Scheduler
| Тағир додашуда: | 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 мебошад ва дар кор бо операторҳо ва агрегаторҳои пайваст таҷрибаи зиёд дорад. Ин платформа барои коркарди ҳаҷми зиёди трафик, нигоҳ доштани дастрасии баланд ва осон кардани масири трафик тавассути пайвастҳои сершумор тарҳрезӣ шудааст.
Ин ҳуҷҷат интерфейси 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
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- рамзгузории маълумот
- sm_length
- паёми кӯтоҳ
Параметрҳои дастгирӣнашаванда:
- намуди_хизмат
- protocol_id
- афзалияти_парчам
- ҷадвали_вақти таҳвил
- иваз_агар_парчам_мозир
- sm_default_msg_id
Шарҳ ки бори пурбор tag дастгирӣ намешавад ва танҳо як SMS метавонад ба як занг расонида шавад ва тавсия дода мешавад, ки эътибори_мӯҳлати tag дорои арзиши 15 дақиқа на камтар аз.
4.4.1 ТОН ва НПИ тавсияшаванда
Ҳангоми фиристодани паёмҳо бо истифода аз фармони ирсол TON ва NPI-и зерин бояд истифода шаванд.
4.4.1.1 Манбаъ
Комбинатсияҳои зерини TON ва NPI барои суроғаи манбаъ дастгирӣ карда мешаванд. Ҳамаи комбинатсияҳои дигар ҳамчун беэътибор баррасӣ карда мешаванд. Фармони пешфарз TON аз пайванд истифода мешавад, агар 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 аз пайванд истифода мешавад, агар 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-паёмҳоро, ки метавонанд дар фосилаи муайяни вақт (ба мисли як рӯз, ҳафта, моҳ ё ба таври номуайян) фиристода шаванд, муайян мекунад. Ҳар як квота бо quotaId (UUID) ба таври беназир муайян карда мешавад ва мувофиқи минтақаи вақти муштарӣ аз нав танзим карда мешавад. Квотаҳоро метавон дар кишвар, минтақа ё сатҳи пешфарз тавассути Quota Pro таъин кардfile. Квота инчунин метавонад бо истифода аз харитаи квота динамикӣ таъин карда шавад. Ин як QuotaId волидайн (UUID) ва Калиди ягонаи квота (масалан, ирсолкунанда ё корбар) ба квотаи мушаххасро харита мекунад.
Квота мувофиқи дастгирии маҳаллии шумо, менеҷери ҳисоби таъиншудаи шумо ё ба таври нобаёнӣ муқаррар карда мешавад, агар ҳеҷ чиз муайян нашуда бошад.
5.2 Ҳолати 106 - Квота гузаштааст
Паёми SMS метавонад бо коди ҳолати 106 («квота гузашт») баста шавад, агар:
- Паём аз маҳдудияти муайяншуда барои квотаи мувофиқи он дар фосилаи ҷорӣ зиёд аст.
- Кишвар ё минтақаи таъиншуда квота таъин накардааст (яъне бо харитаи квотаи нул дар профессионал ба таври возеҳ баста шудааст.file).
- Ягон квотаи мувофиқ вуҷуд надорад ва квотаи пешфарз муайян карда нашудааст, ки дар натиҷа рад карда мешавад.
Дар ин ҳолатҳо, система коркарди минбаъдаи паёмҳоро пешгирӣ мекунад, то маҳдудиятҳои муштариён ё таъинотро риоя кунад ва аз истифодаи нодуруст пешгирӣ кунад.
Ҳисоботи интиқол
Танҳо ҳеҷ як ё расонидани ниҳоӣ бо натиҷаи муваффақ/нокомӣ дастгирӣ карда мешавад.
Формат дар Ҳисоботи таҳвили: ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Sontible: YymMDDHHMM:
Арзишҳои дастрас дар ҳолати:
- ДОДАН
- Мӯҳлаташ гузаштааст
- РАД
- БАРОМАД
- НАЗАР ШУД
6.1 Формати ҳисоботи интиқоли васеъ
Маълумоти васеъ дар гузоришҳои таҳвил мумкин аст дар тамос бо намояндаи фурӯши шумо дархост карда шавад.
Формат дар бораи гузориши таҳвил: ID: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx зер: 000 dlvrd: 000 санаи пешниҳод:
yyMMddHHmm санаи анҷом: yyMMddHHmm омор: хато: матн:
Арзишҳои дастрас дар ҳолати:
- ДОДАН
- Мӯҳлаташ гузаштааст
- РАД
- БАРОМАД
- НАЗАР ШУД
Майдонҳои "sub" ва "dlvrd" ҳамеша ба 000 муқаррар карда мешаванд ва майдони "матн" ҳамеша холӣ хоҳад буд.
Барои арзишҳои майдони "хато" ба боби Рамзҳои хато нигаред.
Версияҳои дастгирӣшудаи 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/
Рамзҳои хато
Рамзҳои хатогии зерин метавонанд дар майдони err ҷавоб дода шаванд, агар майдон фаъол бошад.
| Рамзи хато | Тавсифи |
| 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 | Бо сабаби набудани messageId баргардонида нашуд |
| 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, API Scheduler API, API |