SMS API, SMPP API MS Scheduler API
Колдонуучунун колдонмосу
SMS API, SMPP API MS Scheduler API
| Өзгөртүлгөн: | 6/24/2025 |
| Версия: | 1.7 |
| Author: | Кенни Коландер Норден, KCN |
Бул документ дайындалган алуучуга гана арналган жана артыкчылыктуу, менчиктик же башка жеке маалыматты камтышы мүмкүн. Эгер сиз аны ката менен алган болсоңуз, дароо жөнөтүүчүгө кабарлаңыз жана түпнускасын өчүрүңүз. Документти башка колдонууга тыюу салынат.
Таржымал өзгөртүү
| Аян | Дата | By | Мурунку чыгарылыштан өзгөртүүлөр |
| 1.0 | 2010-03-16 | KCN | түзүлгөн |
| 1. | 2019-06-11 | TPE | Жаңыртылган LINK логотиптери |
| 1. | 2019-09-27 | ПНИ | 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 | Квота кошулду |
Introduction
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 Байлоо
Төмөнкү байланыш буйруктары колдоого алынат.
- Өткөргүч
- Transciever
- Алуучу
Керектүү параметрлер:
- system_id – колдоодон алынган
- сырсөз - колдоо алынган
Кошумча параметрлер:
- addr_ton – тапшыруу учурунда TON Белгисиз деп коюлса, демейки маани.
- addr_npi – тапшыруу учурунда NPI Белгисиз деп коюлса, демейки маани.
Колдоого алынбаган параметрлер:
- дарек_аралыгы
4.2 Unlink
Бошотуу буйругу колдоого алынат.
4.3 Сурап билүү шилтемеси
Сураш шилтеме буйругу колдоого алынат жана ар бир 60 секундада чалылышы керек.
4.4 Тапшыруу
Тапшыруу ыкмасы билдирүүлөрдү жеткирүү үчүн колдонулушу керек.
Керектүү параметрлер:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- кыска_билдирүү
Колдоого алынбаган параметрлер:
- Кызмат түрү
- protocol_id
- артыкчылыктуу_желек
- расписание_жеткирүү_убакыт
- алмаштыруу_эгерде_эле
- sm_default_msg_id
Эскертүү бул пайдалуу жүк tag колдоого алынбайт жана ар бир чалууга бир гана SMS жеткирилиши мүмкүн жана жарактуу_мөөнөтү сунушталат tag кеминде 15 мүнөттүк мааниге ээ.
4.4.1 Сунушталган TON жана NPI
Тапшыруу буйругун колдонуу менен билдирүүлөрдү жөнөтүүдө төмөнкү TON жана NPI колдонулушу керек.
4.4.1.1 Булак
Булак дареги үчүн төмөнкү TON жана NPI айкалыштары колдоого алынат. Бардык башка комбинациялар жараксыз катары каралат. Эгерде TON Белгисиз (0) деп коюлса, демейки TON from bind буйругу колдонулат. Эгерде NPI Белгисиз (0) деп коюлса, байлашуу буйругунан демейки NPI колдонулат.
| ТОН | NPI | Description |
| Алфавиттик (5) | Unknown (0) ISDN (1) |
Алфавиттик-сандык жөнөтүүчү текст катары каралат |
| Эл аралык (1) | Unknown (0) ISDN (1) |
MSISDN катары каралат |
| Улуттук (2) Тармакка тиешелүү (3) Абоненттик номер (4) Кыскартылган (6) |
Unknown (0) ISDN (1) Улуттук (8) |
Өлкөгө тиешелүү кыска номер катары каралат. |
4.4.1.2 Көздөгөн жер
Төмөнкү TON жана NPI айкалыштары көздөгөн дарек үчүн колдоого алынат. Бардык башка комбинациялар жараксыз катары каралат. Эгерде TON Белгисиз (0) деп коюлса, демейки TON from bind буйругу колдонулат. Эгерде NPI Белгисиз (0) деп коюлса, байлашуу буйругунан демейки NPI колдонулат.
| ТОН | NPI | Description |
| Эл аралык (1) | Unknown (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) менен уникалдуу аныкталат жана кардардын убакыт алкагына ылайык баштапкы абалга келтирилет. Квота Pro аркылуу өлкөдө, аймакта же демейки деңгээлде дайындалышы мүмкүнfile. Квота ошондой эле Квота картасын колдонуу менен динамикалык түрдө дайындалышы мүмкүн. Бул ата-энелик QuotaId (UUID) жана уникалдуу квота Ачкычын (мисалы, жөнөтүүчү же колдонуучу) белгилүү бир квотаны аныктайт.
Квота сиздин жергиликтүү колдооңузга, дайындалган эсеп менеджериңизге ылайык же эч нерсе көрсөтүлбөсө демейки боюнча коюлат.
5.2 Статус 106 – Квота ашып кетти
SMS билдирүү 106 статус коду менен бөгөттөлүшү мүмкүн («квота ашты») төмөнкү учурларда:
- Билдирүү учурдагы интервалдын ичиндеги тиешелүү квотанын аныкталган чегинен ашып кетти.
- Бара турган өлкөгө же аймакка квота берилген эмес (б.а. профессионалдык программада нөлдүк квотанын картасы менен ачык эле бөгөттөлгөн)file).
- Эч кандай дал келген квота жана демейки квота аныкталган эмес, натыйжада четке кагуу.
Мындай учурларда, система кардардын же көздөгөн жерине негизделген чектөөлөрдү жана туура эмес колдонууну болтурбоо үчүн билдирүүнү андан ары иштетүүгө жол бербейт.
Жеткирүү отчету
Ийгиликтүү/ийгиликсиз натыйжасы менен эч кимиси же акыркы жеткирүү колдоого алынбайт.
Жеткирүү отчетунун форматы: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx аткарылган датасы: yyMMddHHmm stat:
Статустагы жеткиликтүү маанилер:
- DELIVRD
- МӨНӨТ БҮТКӨН
- ЧЕТ АЛУУ
- UNDELIV
- ЖОК кылынды
6.1 Кеңейтилген жеткирүү отчетунун форматы
Жеткирүү отчетторундагы кеңейтилген маалымат сатуу өкүлүңүз менен байланышууда суралышы мүмкүн.
Жеткирүү отчетунун форматы: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 тапшыруу күнү:
yyMMddHHmm аткарылган датасы: yyMMddHHmm stat: ката: текст:
Статустагы жеткиликтүү маанилер:
- DELIVRD
- МӨНӨТ БҮТКӨН
- ЧЕТ АЛУУ
- UNDELIV
- ЖОК кылынды
"суб" жана "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 портунда.
SMPP ишке ашырууңуз stunnel аркылуу TLSди колдоого албаса дагы, сиз TLS колдоно аласыз, караңыз https://www.stunnel.org/
Ката коддору
Эгер талаа иштетилген болсо, ката талаасында төмөнкү ката коддору жооп бериши мүмкүн.
| Ката коду | Description |
| 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 | Alpha көздөгөн жер катары колдоого алынбайт |
| 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, Scheduler API, API |