SMS API,SMPP API MS Scheduler API
Itọsọna olumulo
SMS API,SMPP API MS Scheduler API
| Títúnṣe: | 6/24/2025 |
| Ẹya: | 1.7 |
| Onkọwe: | Kenny Colander Norden, KCN |
Iwe yi wa fun olugba ti o yan nikan ati pe o le ni anfani, ohun-ini, tabi bibẹẹkọ alaye ikọkọ. Ti o ba ti gba ni aṣiṣe, jọwọ sọfun olufiranṣẹ lẹsẹkẹsẹ ki o pa atilẹba rẹ rẹ. Lilo eyikeyi miiran ti iwe aṣẹ nipasẹ rẹ jẹ eewọ.
Yi itan pada
| Rev | Ọjọ | By | Ayipada lati išaaju Tu |
| 1.0 | 2010-03-16 | KCN | Ti ṣẹda |
| 1. | 2019-06-11 | TPE | Imudojuiwọn RÁNṢẸ awọn apejuwe |
| 1. | 2019-09-27 | PNI | Fi kun tọka si SMPP 3.4 sipesifikesonu |
| 1. | 2019-10-31 | EP | Akiyesi nipa awọn Wiwulo akoko tag |
| 1. | 2020-08-28 | KCN | Alaye ti a ṣafikun nipa awọn ẹya TLS ti o ni atilẹyin |
| 2. | 2022-01-10 | KCN | Afikun alaye nipa awọn ijabọ ifijiṣẹ Alaye imudojuiwọn nipa TLS 1.3 |
| 2. | 2025-06-03 | GM | Koodu abajade ti a ṣafikun 2108 |
| 2. | 2025-06-24 | AK | Fi kun ipin |
Ọrọ Iṣaaju
LINK Iṣipopada ti jẹ olupin SMS lati ọdun 2001 ati pe o ni iriri pupọ ni ṣiṣẹ pẹlu awọn oniṣẹ mejeeji ati awọn apejọ asopọ. A ṣe apẹrẹ pẹpẹ yii lati mu awọn iwọn ijabọ nla, ṣetọju wiwa giga ati jẹ ki o rọrun lati ṣe ipa ọna opopona nipasẹ awọn asopọ pupọ.
Eleyi jẹ iwe apejuwe awọn SMPP ni wiwo si SMSC-Syeed ati eyi ti paramita ati awọn ofin ti o ti wa ni ti beere ati eyi ti sile ni atilẹyin.
Iwe yii kii yoo mu awọn ọran lilo kan pato bi awọn ifiranšẹ isomọ, WAPpush, Flash SMS, ati bẹbẹ lọ Alaye diẹ sii nipa awọn ọran wọnyẹn le jẹ pese nipasẹ kikan si atilẹyin.
Awọn aṣẹ atilẹyin
Olupin arinbo LINK yẹ ki o ṣe itọju bi SMPP 3.4. Awọn osise sipesifikesonu le ri ni https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Gbogbo awọn ọna ko ni atilẹyin, ati gbogbo awọn iyatọ ti wa ni pato ni isalẹ.
4.1 Dipọ
Awọn pipaṣẹ dipọ atẹle ni atilẹyin.
- Atagba
- Transciever
- Olugba
Awọn paramita ti a beere:
- system_id – gba lati support
- ọrọigbaniwọle – gba lati support
Awọn paramita iyan:
- addr_ton – iye aiyipada ti TON ba ṣeto si Aimọ lakoko ifisilẹ.
- addr_npi – iye aiyipada ti o ba ṣeto NPI si Aimọ lakoko ifisilẹ.
Awọn paramita ti ko ni atilẹyin:
- adirẹsi_ibiti
4.2 Yọ
Aṣẹ yiyọ kuro ni atilẹyin.
4.3 Beere ọna asopọ
Aṣẹ ọna asopọ ibeere naa ni atilẹyin ati pe o yẹ ki o pe ni gbogbo awọn aaya 60.
4.4 Fi silẹ
Ọna ifisilẹ yẹ ki o lo fun jiṣẹ awọn ifiranṣẹ.
Awọn paramita ti a beere:
- orisun_addr_ton
- orisun_addr_npi
- orisun_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_kilasi
- data_coding
- sm_ipari
- kukuru_ifiranṣẹ
Awọn paramita ti ko ni atilẹyin:
- service_type
- Ilana_id
- ayo_flag
- time_delivery_time
- rọpo_if_present_flag
- sm_default_msg_id
Akiyesi wipe awọn payload tag ko ṣe atilẹyin ati pe SMS kan ṣoṣo ni o le fi jiṣẹ fun ipe kan ati pe o gba ọ niyanju pe iwulo_period naa tag ni iye ti 15 iṣẹju gun ni o kere.
4.4.1 Niyanju TON ati NPI
TON atẹle ati NPI yẹ ki o lo nigba fifiranṣẹ awọn ifiranṣẹ nipa lilo aṣẹ ifisilẹ.
4.4.1.1 Orisun
Awọn akojọpọ TON ati NPI atẹle jẹ atilẹyin fun adirẹsi orisun. Gbogbo awọn akojọpọ miiran yoo ṣe itọju bi aitọ. TON aiyipada lati aṣẹ dipọ yoo ṣee lo ti TON ba ṣeto si Aimọ (0). NPI aiyipada lati aṣẹ dipọ yoo ṣee lo ti NPI ti ṣeto si Aimọ (0).
| TON | NPI | Apejuwe |
| Alfa nomba (5) | Aimọ (0) ISDN (1) |
Yoo ṣe itọju bi ọrọ olufiranṣẹ Alphanumeric |
| Orílẹ̀-èdè (1) | Aimọ (0) ISDN (1) |
Yoo ṣe itọju bi MSISDN |
| Orílẹ̀-èdè (2) Nẹtiwọọki kan pato (3) Nọmba alabapin (4) Kukuru (6) |
Aimọ (0) ISDN (1) Orílẹ̀-èdè (8) |
Yoo ṣe itọju bi nọmba kukuru ti orilẹ-ede kan pato. |
4.4.1.2 nlo
Awọn akojọpọ TON ati NPI atẹle jẹ atilẹyin fun adirẹsi opin irin ajo. Gbogbo awọn akojọpọ miiran yoo ṣe itọju bi aitọ. TON aiyipada lati aṣẹ dipọ yoo ṣee lo ti TON ba ṣeto si Aimọ (0). NPI aiyipada lati aṣẹ dipọ yoo ṣee lo ti NPI ti ṣeto si Aimọ (0).
| TON | NPI | Apejuwe |
| Orílẹ̀-èdè (1) | Aimọ (0) ISDN (1) |
Yoo ṣe itọju bi MSISDN |
4.4.2 Awọn koodu atilẹyin
Awọn fifi koodu atẹle jẹ atilẹyin. X le ni iye eyikeyi ninu.
| DCS | fifi koodu |
| 0xX0 | Alfabeti GSM aiyipada pẹlu itẹsiwaju |
| 0xX2 | 8-bit alakomeji |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Pipin
5.1 Pipa Pipaview
Ipin kan n ṣalaye nọmba ti o pọju ti awọn ifiranṣẹ SMS ti o le firanṣẹ laarin aarin akoko kan pato (gẹgẹbi ọjọ kan, ọsẹ, oṣu, tabi lainidi). Ipin kọọkan jẹ idanimọ ni iyasọtọ nipasẹ quotaId (UUID) ati pe a tunto ni ibamu si agbegbe aago onibara. Awọn ipin le jẹ sọtọ ni orilẹ-ede, agbegbe, tabi ipele aiyipada nipasẹ Quota Profile. Quota le tun ti wa ni agbara sọtọ nipa lilo Quota Mapping. Eyi ṣe maapu obi QuotaId (UUID) ati bọtini ipin alailẹgbẹ (fun apẹẹrẹ, olufiranṣẹ tabi olumulo) si ipin kan pato.
A ṣeto ipin kan ni ibamu pẹlu atilẹyin agbegbe rẹ, oluṣakoso akọọlẹ ti a yàn tabi nipasẹ aiyipada ti ko ba si pato.
5.2 Ipo 106 - Quota ti kọja
Ifiranṣẹ SMS le dina mọ pẹlu koodu ipo 106 (“iye ti kọja”) nigbati:
- Ifiranṣẹ naa kọja opin asọye fun ipin ti o baamu rẹ laarin aarin lọwọlọwọ.
- Orilẹ-ede ti o nlo tabi agbegbe ko ni ipin ti a yàn (ie, ti dinamọ ni gbangba pẹlu iyaworan ipin ipin asan ninu profile).
- Ko si ipin ti o baamu ko si si ipin aiyipada ti wa ni asọye, Abajade ni ijusile.
Ni awọn iṣẹlẹ wọnyi, eto naa ṣe idiwọ sisẹ ifiranṣẹ siwaju lati fi ipa mu alabara tabi awọn opin opin irin-ajo ati yago fun ilokulo.
Iroyin ifijiṣẹ
Nikan ko si tabi ifijiṣẹ ipari pẹlu abajade aṣeyọri/ikuna ni atilẹyin.
Ọna kika lori ijabọ ifijiṣẹ: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ọjọ ti o ti pari: yyMMddHHmm iṣiro:
Awọn iye to wa ni ipo:
- DELIVRD
- EXPIRED
- KỌDE
- UNDELIV
- PAArẹ
6.1 Itẹsiwaju kika Iroyin ifijiṣẹ
Alaye ti o gbooro ninu awọn ijabọ ifijiṣẹ le beere ni olubasọrọ pẹlu aṣoju tita rẹ.
Ọna kika lori ijabọ ifijiṣẹ: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd:000 ọjọ ifisilẹ:
yyMMddHHmm ṣe ọjọ: yyMMddHHmm iṣiro: asise: ọrọ:
Awọn iye to wa ni ipo:
- DELIVRD
- EXPIRED
- KỌDE
- UNDELIV
- PAArẹ
Awọn aaye “sub” ati “dlvrd” yoo ma ṣeto si 000 nigbagbogbo, ati aaye “ọrọ” yoo ma jẹ ofo nigbagbogbo.
Wo awọn koodu aṣiṣe ipin fun awọn iye fun aaye “aṣiṣe”.
Awọn ẹya TLS atilẹyin
TLS 1.2 tabi TLS 1.3 ni a nilo fun gbogbo awọn asopọ TLS lori SMPP.
Atilẹyin fun TLS 1.0 ati 1.1 ti dawọ duro lati ọdun 2020-11-15. Awọn ẹya 1.0 ati 1.1 ti TLS jẹ awọn ilana ti o ti dagba ti a ti parẹ ati pe a gba bi awọn eewu aabo ni agbegbe Intanẹẹti.
RÁNṢẸ ṣeduro ni iyanju lati lo TLS ti awọn asopọ SMPP ti ko paro ni lilo loni. Awọn asopọ SMPP ti ko paro ni a ti parẹ lati ọdun 2020-09-01 nipasẹ LINK, ati pe yoo yọkuro ni ọjọ iwaju. Ọjọ fun yiyọkuro awọn asopọ ti a ko pa akoonu ko tii pinnu.
Awọn isopọ si olupin SMPP fun TLS wa ni ibudo 3601 dipo ti a ko pa akoonu ni ibudo 3600.
O tun le lo TLS paapaa ti imuse SMPP rẹ ko ṣe atilẹyin TLS nipa lilo stunnel, wo https://www.stunnel.org/
Awọn koodu aṣiṣe
Awọn koodu aṣiṣe wọnyi le dahun ni aaye aṣiṣe ti aaye naa ba ṣiṣẹ.
| Koodu aṣiṣe | Apejuwe |
| 0 | Aṣiṣe aimọ |
| 1 | Aṣiṣe ipa ọna igba diẹ |
| 2 | Yẹ afisona aṣiṣe |
| 3 | Fifun ti o pọju ti kọja |
| 4 | Duro na |
| 5 | Aṣiṣe aimọ oniṣẹ |
| 6 | Aṣiṣe oniṣẹ |
| 100 | Iṣẹ ko ri |
| 101 | A ko ri olumulo |
| 102 | A ko ri akoto |
| 103 | Ọrọigbaniwọle ti ko tọ |
| 104 | Aṣiṣe iṣeto ni |
| 105 | Aṣiṣe inu |
| 106 | Iye ti kọja |
| 200 | OK |
| 1000 | Ti firanṣẹ |
| 1001 | Ti fi jiṣẹ |
| 1002 | Ti pari |
| 1003 | Parẹ |
| 1004 | Mobile kun |
| 1005 | Ti o wa ni ila |
| 1006 | Ko jiṣẹ |
| 1007 | Jiṣẹ, idiyele idaduro |
| 1008 | Ti gba agbara, ifiranṣẹ ko firanṣẹ |
| 1009 | Ti gba agbara, ifiranṣẹ ko firanṣẹ |
| 1010 | Ti pari, isansa ti ijabọ ifijiṣẹ oniṣẹ |
| 1011 | Ti gba agbara, ifiranṣẹ ranṣẹ (si oniṣẹ) |
| 1012 | Latọna jijin ti isinyi |
| 1013 | Ifiranṣẹ ranṣẹ si oniṣẹ ẹrọ, gbigba agbara idaduro |
| 2000 | Nọmba orisun ti ko tọ |
| 2001 | Nọmba kukuru ko ni atilẹyin bi orisun |
| 2002 | Alpha ko ni atilẹyin bi orisun |
| 2003 | MSISDN ko ṣe atilẹyin bi nọmba orisun |
| 2100 | Nọmba kukuru ko ni atilẹyin bi opin irin ajo |
| 2101 | Ko ṣe atilẹyin Alfa bi opin irin ajo |
| 2102 | A ko ṣe atilẹyin MSISDN bi opin irin ajo |
| 2103 | Ti dina mọ isẹ |
| 2104 | Alabapin aimọ |
| 2105 | Ti dina mọ ibi |
| 2106 | Aṣiṣe nọmba |
| 2107 | Ti dina mọ ibi-afẹde fun igba diẹ |
| 2108 | Ibi ti ko tọ |
| 2200 | Aṣiṣe gbigba agbara |
| 2201 | Alabapin ni iwọntunwọnsi kekere |
|
2202 |
Alabapin ni idinamọ fun idiyele ti o pọju (ọya)
awọn ifiranṣẹ |
|
2203 |
Alabapin ju ọdọ (fun pato yii
akoonu) |
| 2204 | Alabapin asansilẹ ko gba laaye |
| 2205 | Iṣẹ ti a kọ nipasẹ alabapin |
| 2206 | Alabapin ko forukọsilẹ ni eto isanwo |
| 2207 | Alabapin ti de iwọntunwọnsi ti o pọju |
| 2208 | Ijẹrisi olumulo ipari nilo |
| 2300 | agbapada |
|
2301 |
Ko le dapada nitori arufin tabi sonu
MSISDN |
| 2302 | Ko le dapada nitori ifiranṣẹId sonu |
| 2303 | Ti wa ni isinyi fun agbapada |
| 2304 | Aago agbapada |
| 2305 | Ikuna agbapada |
| 3000 | GSM fifi koodu ko ni atilẹyin |
| 3001 | UCS2 fifi koodu ko ni atilẹyin |
| 3002 | Iyipada koodu alakomeji ko ni atilẹyin |
| 4000 | Iroyin ifijiṣẹ ko ni atilẹyin |
| 4001 | Akoonu ifiranṣẹ ti ko tọ |
| 4002 | Owo idiyele ti ko tọ |
| 4003 | Data olumulo ti ko tọ |
| 4004 | Akọsori data olumulo ti ko tọ |
| 4005 | Ifaminsi data ti ko tọ |
| 4006 | VAT ti ko tọ |
| 4007 | Akoonu ti ko ni atilẹyin fun opin irin ajo |
Awọn iwe aṣẹ / Awọn orisun
 |
ọna asopọ arinbo SMS API,SMPP API MS Scheduler API [pdf] Itọsọna olumulo SMS API SMPP API MS Iṣeto API, SMS API SMPP API, API Iṣeto MS, API Iṣeto, API |