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 Тайлах
Unbind командыг дэмждэг.
4.3 Лавлах холбоос
Inquire link командыг дэмждэг бөгөөд 60 секунд тутамд залгах ёстой.
4.4 Илгээх
Илгээх аргыг мессежийг хүргэхэд ашиглах ёстой.
Шаардлагатай параметрүүд:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- өгөгдөл_кодлох
- см_урт
- богино_мессеж
Дэмжигдээгүй параметрүүд:
- үйлчилгээний_төрөл
- протокол_id
- тэргүүлэх_туг
- хуваарь хүргэх_цаг
- тугийг_орлуулах
- sm_default_msg_id
Анхаарна уу тэр ачаалал tag дэмжигдээгүй бөгөөд нэг дуудлагад зөвхөн нэг SMS илгээх боломжтой бөгөөд хүчинтэй_хугацаатай байхыг зөвлөж байна tag хамгийн багадаа 15 минутын урттай.
4.4.1 Санал болгож буй ТОН ба NPI
Submit командыг ашиглан мессеж илгээхдээ дараах TON болон NPI-г ашиглах ёстой.
4.4.1.1 Эх сурвалж
Дараах TON болон NPI хослолуудыг эх хаягийн хувьд дэмждэг. Бусад бүх хослолыг хүчингүйд тооцно. Хэрэв TON-г Unknown (0) болгож тохируулсан бол анхдагч TON from bind командыг ашиглана. Хэрэв NPI-г Үл мэдэгдэх (0) болгож тохируулсан бол bind-ийн үндсэн 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-г Unknown (0) болгож тохируулсан бол анхдагч TON from bind командыг ашиглана. Хэрэв NPI-г Үл мэдэгдэх (0) болгож тохируулсан бол bind-ийн үндсэн 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) өвөрмөц байдлаар тодорхойлдог бөгөөд хэрэглэгчийн цагийн бүсийн дагуу дахин тохируулдаг. Квота Pro-ээр дамжуулан улс, бүс нутаг эсвэл анхдагч түвшинд квот оноож болноfile. Квотын зураглалыг ашиглан динамикаар хуваарилж болно. Энэ нь эцэг эхийн QuotaId (UUID) болон өвөрмөц квотын түлхүүрийг (жишээ нь, илгээгч эсвэл хэрэглэгч) тодорхой квотын дугаарт буулгана.
Таны орон нутгийн дэмжлэг, томилогдсон дансны менежерийн дагуу эсвэл юу ч заагаагүй бол анхдагчаар квотыг тогтооно.
5.2 Статус 106 – Квот хэтэрсэн
Дараах тохиолдолд SMS мессежийг 106 статус кодоор ("квот хэтэрсэн") блоклож болно.
- Зурвас нь одоогийн интервалд тохирох квотын тодорхойлогдсон хязгаараас хэтэрсэн байна.
- Очих улс эсвэл бүс нутагт квот оногдоогүй (өөрөөр хэлбэл, мэргэжлийн программ дахь хоосон квотын зураглалаар тодорхой блоклогдсон)file).
- Тохирох квот байхгүй бөгөөд өгөгдмөл квот тодорхойлогдоогүй тул татгалзсан байна.
Эдгээр тохиолдолд систем нь үйлчлүүлэгч эсвэл очих газарт суурилсан хязгаарлалтыг хэрэгжүүлэх, буруугаар ашиглахаас зайлсхийхийн тулд мессежийг цаашид боловсруулахаас сэргийлдэг.
Хүргэлтийн тайлан
Амжилттай/бүтэлгүйтсэн үр дүн бүхий зөвхөн байхгүй эсвэл эцсийн хүргэлтийг дэмждэг.
Хүргэлтийн тайлангийн формат: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx дууссан огноо: yyMMddHHmm stat:
Статус дахь боломжтой утгууд:
- ХҮРГҮҮЛЭХ
- ХУГАЦАА ДУУССАН
- ТАТГАЛЗАХГ
- БУЦАХ
- УСТГАСАН
6.1 Өргөтгөсөн хүргэлтийн тайлангийн хэлбэр
Хүргэлтийн тайлан дахь өргөтгөсөн мэдээллийг борлуулалтын төлөөлөгчтэйгээ холбоо барьж асууж болно.
Хүргэлтийн тайлангийн формат: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 Илгээх огноо:
yyMMddHHmm дууссан огноо: yyMMddHHmm стат: алдаа: текст:
Статус дахь боломжтой утгууд:
- ХҮРГҮҮЛЭХ
- ХУГАЦАА ДУУССАН
- ТАТГАЛЗАХГ
- БУЦАХ
- УСТГАСАН
"Дэд" болон "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 холболтыг 2020 оны 09-р сарын 01-ний өдрөөс эхлэн LINK-р цуцалсан бөгөөд цаашид устгах болно. Шифрлэгдээгүй холболтыг устгах огноо хараахан шийдэгдээгүй байна.
TLS-д зориулсан SMPP сервер рүү холбогдох холболтууд нь 3601 порт дээр шифрлэгдээгүй бол 3600 порт дээр байна.
Таны SMPP хэрэгжилт нь stunnel ашиглан TLS-г дэмждэггүй байсан ч та TLS-г ашиглаж болно 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 | Мессежийн дугаар дутуу байгаа тул буцаан олгох боломжгүй |
| 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 |