SMS API, SMPP API MS Scheduler API
Vartotojo vadovas
SMS API, SMPP API MS Scheduler API
| Modifikuota: | 6-24-2025 |
| Versija: | 1.7 |
| Autorius: | Kenny Colander Norden, KCN |
Šis dokumentas skirtas tik nurodytam gavėjui ir jame gali būti privilegijuotos, nuosavybės ar kitokios privačios informacijos. Jei jį gavote per klaidą, nedelsdami praneškite siuntėjui ir ištrinkite originalą. Bet koks kitoks jūsų dokumento naudojimas yra draudžiamas.
Pakeitimų istorija
| Rev | Data | By | Pakeitimai, palyginti su ankstesniu leidimu |
| 1.0 | 2010-03-16 | KCN | Sukurta |
| 1. | 2019-06-11 | TPE | Atnaujinti LINK logotipai |
| 1. | 2019-09-27 | PNI | Pridėta nuoroda į SMPP 3.4 specifikaciją |
| 1. | 2019-10-31 | EP | Pastaba apie galiojimo laiką tag |
| 1. | 2020-08-28 | KCN | Pridėta informacija apie palaikomas TLS versijas |
| 2. | 2022-01-10 | KCN | Pridėta papildomos informacijos apie pristatymo ataskaitas Atnaujinta informacija apie TLS 1.3 |
| 2. | 2025-06-03 | GM | Pridėtas rezultato kodas 2108 |
| 2. | 2025-06-24 | AK | Pridėta kvota |
Įvadas
LINK Mobility yra SMS platintojas nuo 2001 m. ir turi daug patirties dirbant tiek su operatoriais, tiek su ryšių agregatoriais. Ši platforma skirta valdyti didelius srautus, palaikyti aukštą pasiekiamumą ir palengvinti srauto nukreipimą keliais ryšiais.
Šiame dokumente aprašoma SMPP sąsaja su SMSC platforma, kokie parametrai ir komandos yra būtini ir kurie parametrai yra palaikomi.
Šiame dokumente nebus nagrinėjami konkretūs naudojimo atvejai, tokie kaip sujungtos žinutės, WAPpush, „Flash SMS“ ir kt. Daugiau informacijos apie šiuos atvejus galite gauti susisiekę su palaikymo tarnyba.
Palaikomos komandos
LINK Mobilumo serveris turėtų būti traktuojamas kaip SMPP 3.4. Oficialią specifikaciją galite rasti adresu https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Visi metodai nepalaikomi, o visi skirtumai nurodyti toliau.
4.1 Surišti
Palaikomos šios susiejimo komandos.
- Siųstuvas
- Transciveris
- Imtuvas
Reikalingi parametrai:
- system_id – gautas iš palaikymo
- slaptažodis – gautas iš palaikymo
Pasirenkami parametrai:
- addr_ton – numatytoji reikšmė, jei pateikimo metu TON nustatyta kaip Nežinoma.
- addr_npi – numatytoji reikšmė, jei pateikimo metu NPI nustatyta kaip Nežinoma.
Nepalaikomi parametrai:
- adreso_diapazonas
4.2 Atsieti
Atrišimo komanda palaikoma.
4.3 Nuoroda teirautis
Palaikoma nuoroda „Inquire Link“ ir turėtų būti iškviečiama kas 60 sekundžių.
4.4 Pateikti
Pranešimams pristatyti turėtų būti naudojamas pateikimo metodas.
Reikalingi parametrai:
- source_addr_ton
- source_addr_npi
- šaltinio_adresas
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- duomenų_kodavimas
- sm_ilgis
- Trumpa zinute
Nepalaikomi parametrai:
- paslaugos_tipas
- protokolo_id
- prioriteto_vėliava
- tvarkaraštis_pristatymo_laikas
- pakeisti_jei_esama_vėliava
- sm_default_msg_id
Pastaba kad naudingoji apkrova tag nepalaikomas ir vienam skambučiui gali būti pristatyta tik viena SMS, todėl rekomenduojama, kad validity_period tag jo vertė yra mažiausiai 15 minučių.
4.4.1 Rekomenduojamas TON ir NPI
Siunčiant pranešimus naudojant komandą pateikti, turėtų būti naudojami šie TON ir NPI.
4.4.1.1 Šaltinis
Šaltinio adresui palaikomi šie TON ir NPI deriniai. Visi kiti deriniai bus laikomi negaliojančiais. Numatytasis TON iš susiejimo komandos bus naudojamas, jei TON nustatytas kaip nežinomas (0). Numatytasis NPI iš susiejimo komandos bus naudojamas, jei NPI nustatytas kaip nežinomas (0).
| TON | NPI | Aprašymas |
| Raidinis ir skaitinis (5) | Nežinoma (0) ISDN (1) |
Bus traktuojamas kaip raidinis ir skaitmeninis siuntėjo tekstas |
| Tarptautinė (1) | Nežinoma (0) ISDN (1) |
Bus traktuojamas kaip MSISDN |
| Nacionalinis (2) Tinklui būdingas (3) Abonento numeris (4) Sutrumpintas (6) |
Nežinoma (0) ISDN (1) Nacionalinis (8) |
Bus traktuojamas kaip šalies trumpasis numeris. |
4.4.1.2 Paskirties vieta
Paskirties adresu palaikomi šie TON ir NPI deriniai. Visi kiti deriniai bus laikomi negaliojančiais. Numatytoji komanda TON from bind bus naudojama, jei TON nustatyta kaip Unknown (0). Numatytoji komanda NPI from bind bus naudojama, jei NPI nustatyta kaip Unknown (0).
| TON | NPI | Aprašymas |
| Tarptautinė (1) | Nežinoma (0) ISDN (1) |
Bus traktuojamas kaip MSISDN |
4.4.2 Palaikomos koduotės
Palaikomos šios koduotės. X gali turėti bet kokią reikšmę.
| DCS | Kodavimas |
| 0xX0 | Numatytoji GSM abėcėlė su plėtiniu |
| 0xX2 | 8 bitų dvejetainis |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Kvotos viršijimasview
Kvota apibrėžia maksimalų SMS žinučių skaičių, kurį galima išsiųsti per tam tikrą laiko intervalą (pvz., per dieną, savaitę, mėnesį ar neribotą laiką). Kiekviena kvota yra unikaliai identifikuojama pagal kvotos ID (UUID) ir yra nustatoma iš naujo pagal kliento laiko juostą. Kvotas galima priskirti šalies, regiono arba numatytuoju lygiu naudojant „Quota Pro“.fileKvotą taip pat galima priskirti dinamiškai naudojant kvotų susiejimą. Tai susieja pirminį kvotos ID (UUID) ir unikalų kvotos raktą (pvz., siuntėją arba vartotoją) su konkrečiu kvotos ID.
Kvota nustatoma pagal jūsų vietinės pagalbos tarnybos nurodymus, jums priskirtą paskyros valdytoją arba pagal numatytuosius nustatymus, jei nieko nenurodyta.
5.2 106 būsena – viršyta kvota
SMS žinutė gali būti užblokuota su būsenos kodu 106 („viršyta kvota“), kai:
- Pranešimas viršija atitinkamo kvotos ID nustatytą ribą dabartiniame intervale.
- Paskirties šaliai arba regionui nepriskirta kvota (t. y. jis yra aiškiai užblokuotas su nuline kvotos kortele programoje).file).
- Nėra atitinkamos kvotos ir nenustatyta numatytoji kvota, todėl paraiška atmetama.
Tokiais atvejais sistema neleidžia toliau apdoroti pranešimų, kad būtų taikomi kliento arba paskirties vietos apribojimai ir išvengta netinkamo naudojimo.
Pristatymo ataskaita
Palaikomas tik joks pristatymas arba galutinis pristatymas su sėkmingu / nesėkmingu rezultatu.
Pristatymo ataskaitos formatas: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx atlikimo data: yyMMddHHmm stat:
Galimos reikšmės būsenoje:
- PRISTATYMAS
- BAIGĖSI
- ATMESTA
- NEPRISTATYMAS
- IŠTRINTA
6.1 Išplėstinės pristatymo ataskaitos formatas
Išsamesnės informacijos pristatymo ataskaitose galite paprašyti susisiekę su savo pardavimo atstovu.
Pristatymo ataskaitos formatas: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 pateikimo data:
mmmmddhhmm atlikimo data: mmmmddhhmm statistika: klaida: tekstas:
Galimos reikšmės būsenoje:
- PRISTATYMAS
- BAIGĖSI
- ATMESTA
- NEPRISTATYMAS
- IŠTRINTA
Laukai „sub“ ir „dlvrd“ visada bus nustatyti į 000, o laukas „tekstas“ visada bus tuščias.
Lauko „err“ reikšmes žr. skyriuje „Klaidų kodai“.
Palaikomos TLS versijos
TLS 1.2 arba TLS 1.3 reikalingas visiems TLS ryšiams per SMPP.
TLS 1.0 ir 1.1 palaikymas nutraukiamas nuo 2020-11-15. TLS 1.0 ir 1.1 versijos yra senesni protokolai, kurie buvo nebenaudojami ir interneto bendruomenėje laikomi saugumo rizika.
LINK primygtinai rekomenduojame naudoti TLS, jei šiandien naudojami nešifruoti SMPP ryšiai. Nešifruoti SMPP ryšiai yra nebenaudojami nuo 2020-09-01 LINK ir bus pašalinti ateityje. Nešifruotų ryšių pašalinimo data dar nenustatyta.
Ryšiai su TLS SMPP serveriu yra 3601 prievade, o ne nešifruoti prie 3600 prievado.
Vis tiek galite naudoti TLS, net jei jūsų SMPP diegimas nepalaiko TLS naudojant stunnel, žr https://www.stunnel.org/
Klaidų kodai
Jei laukas įjungtas, klaidų lauke gali būti atsakyta į šiuos klaidų kodus.
| Klaidos kodas | Aprašymas |
| 0 | Nežinoma klaida |
| 1 | Laikina maršruto parinkimo klaida |
| 2 | Nuolatinė maršruto klaida |
| 3 | Viršytas maksimalus droselis |
| 4 | Skirtasis laikas |
| 5 | Nežinoma operatoriaus klaida |
| 6 | Operatoriaus klaida |
| 100 | Paslauga nerasta |
| 101 | Vartotojas nerastas |
| 102 | Paskyra nerasta |
| 103 | Neteisingas slaptažodis |
| 104 | Konfigūracijos klaida |
| 105 | Vidinė klaida |
| 106 | Kvota viršyta |
| 200 | OK |
| 1000 | Išsiųsta |
| 1001 | Pristatyta |
| 1002 | Baigėsi galiojimo laikas |
| 1003 | Ištrinta |
| 1004 | Pilnas mobilusis |
| 1005 | Eilėje |
| 1006 | Nepristatytas |
| 1007 | Pristatytas, apmokestinimas atidėtas |
| 1008 | Apmokestintas, žinutė neišsiųsta |
| 1009 | Apmokestintas, žinutė nepristatyta |
| 1010 | Baigėsi galiojimo laikas, nėra operatoriaus pristatymo ataskaitos |
| 1011 | Apmokestinta, žinutė išsiųsta (operatoriui) |
| 1012 | Nuotoliniu būdu eilėje |
| 1013 | Pranešimas išsiųstas operatoriui, įkrovimas atidėtas |
| 2000 | Neteisingas šaltinio numeris |
| 2001 | Trumpasis numeris nepalaikomas kaip šaltinis |
| 2002 | Alfa nepalaikoma kaip šaltinis |
| 2003 | MSISDN nepalaikomas kaip šaltinio numeris |
| 2100 | Trumpasis numeris nepalaikomas kaip paskirties vieta |
| 2101 | Alfa nepalaikoma kaip paskirties vieta |
| 2102 | MSISDN nepalaikomas kaip paskirties vieta |
| 2103 | Operacija užblokuota |
| 2104 | Nežinomas prenumeratorius |
| 2105 | Paskirties vieta užblokuota |
| 2106 | Skaičių klaida |
| 2107 | Paskirties vieta laikinai užblokuota |
| 2108 | Neteisinga paskirties vieta |
| 2200 | Įkrovimo klaida |
| 2201 | Abonento balansas mažas |
|
2202 |
Prenumeratoriui uždrausta dėl per didelio mokesčio (premium)
žinutes |
|
2203 |
Prenumeratorius per jaunas (šiam konkrečiam atvejui)
turinys) |
| 2204 | Išankstinio mokėjimo abonentas neleidžiamas |
| 2205 | Paslaugą atmetė abonentas |
| 2206 | Abonentas neregistruotas mokėjimo sistemoje |
| 2207 | Abonentas pasiekė maksimalų balansą |
| 2208 | Reikalingas galutinio vartotojo patvirtinimas |
| 2300 | Grąžinta |
|
2301 |
Negalėjau grąžinti pinigų dėl neteisėto arba trūkstamo
MSISDN |
| 2302 | Nepavyko grąžinti pinigų, nes trūksta pranešimo ID |
| 2303 | Atsidūrė eilėje dėl pinigų grąžinimo |
| 2304 | Pinigų grąžinimo skirtasis laikas |
| 2305 | Nepavyko grąžinti pinigų |
| 3000 | GSM kodavimas nepalaikomas |
| 3001 | UCS2 kodavimas nepalaikomas |
| 3002 | Dvejetainis kodavimas nepalaikomas |
| 4000 | Pristatymo ataskaita nepalaikoma |
| 4001 | Neteisingas pranešimo turinys |
| 4002 | Neteisingas tarifas |
| 4003 | Netinkami naudotojo duomenys |
| 4004 | Netinkama naudotojo duomenų antraštė |
| 4005 | Netinkamas duomenų kodavimas |
| 4006 | Neteisingas PVM |
| 4007 | Nepalaikomas paskirties vietos turinys |
Dokumentai / Ištekliai
 |
nuorodų mobilumo SMS API, SMPP API MS planuoklio API [pdfVartotojo vadovas SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Planuoklio API, API |