SMS API, SMPP API MS Scheduler API
Uporabniški priročnik
SMS API, SMPP API MS Scheduler API
| spremenjeno: | 6/24/2025 |
| Različica: | 1.7 |
| Avtor: | Kenny Colander Norden, KCN |
Ta dokument je samo za določenega prejemnika in lahko vsebuje privilegirane, lastniške ali kako drugače zasebne podatke. Če ste ga prejeli pomotoma, o tem takoj obvestite pošiljatelja in izvirnik izbrišite. Kakršna koli druga uporaba dokumenta z vaše strani je prepovedana.
Zgodovina sprememb
| Rev | Datum | By | Spremembe glede na prejšnjo izdajo |
| 1.0 | 2010-03-16 | KCN | Ustvarjeno |
| 1. | 2019-06-11 | TPE | Posodobljeni logotipi LINK |
| 1. | 2019-09-27 | PNI | Dodan sklic na specifikacijo SMPP 3.4 |
| 1. | 2019-10-31 | EP | Opazovanje glede roka veljavnosti tag |
| 1. | 2020-08-28 | KCN | Dodane informacije o podprtih različicah TLS |
| 2. | 2022-01-10 | KCN | Dodane dodatne informacije o poročilih o dostavi Posodobljene informacije o TLS 1.3 |
| 2. | 2025-06-03 | GM | Dodana koda rezultata 2108 |
| 2. | 2025-06-24 | AK | Dodana kvota |
Uvod
LINK Mobility je SMS distributer že od leta 2001 in ima veliko izkušenj pri sodelovanju tako z operaterji kot z agregatorji povezav. Ta platforma je zasnovana za obvladovanje velikih količin prometa, vzdrževanje visoke razpoložljivosti in omogoča enostavno usmerjanje prometa prek več povezav.
Ta dokument opisuje vmesnik SMPP za platformo SMSC ter kateri parametri in ukazi so potrebni in kateri parametri so podprti.
Ta dokument ne bo obravnaval specifičnih primerov uporabe, kot so združena sporočila, WAPpush, Flash SMS itd. Za več informacij o teh primerih se lahko obrnete na podporo.
Podprti ukazi
Strežnik LINK Mobility je treba obravnavati kot SMPP 3.4. Uradne specifikacije najdete na https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Vse metode niso podprte in vse razlike so navedene spodaj.
4.1 Vezava
Podprti so naslednji ukazi za povezovanje.
- Oddajnik
- Oddajnik
- Sprejemnik
Zahtevani parametri:
- system_id – pridobljeno od podpore
- geslo – pridobljeno od podpore
Izbirni parametri:
- addr_ton – privzeta vrednost, če je TON med pošiljanjem nastavljen na Neznano.
- addr_npi – privzeta vrednost, če je NPI med pošiljanjem nastavljen na Neznano.
Nepodprti parametri:
- obseg_naslovov
4.2 Odvezati
Ukaz unbind je podprt.
4.3 Povezava za povpraševanje
Ukaz inquire link je podprt in ga je treba poklicati vsakih 60 sekund.
4.4 Predloži
Za dostavo sporočil je treba uporabiti metodo pošiljanja.
Zahtevani parametri:
- izvorni_naslov
- izvorni_naslov_npi
- izvorni_naslov
- ciljni_naslov_ton
- dest_addr_npi
- ciljni_naslov
- esm_razred
- podatkovno_kodiranje
- sm_dolžina
- kratko_sporočilo
Nepodprti parametri:
- vrsta_storitve
- protocol_id
- prednostna_zastavica
- razpored_čas_dostave
- zamenjaj_če_je_prisotna_zastavica
- sm_default_msg_id
Opomba da je tovor tag ni podprto in na klic je lahko dostavljen samo en SMS, zato je priporočljivo, da veljavnost_period tag ima vrednost vsaj 15 minut.
4.4.1 Priporočeni TON in NPI
Pri pošiljanju sporočil z ukazom za pošiljanje je treba uporabiti naslednja TON in NPI.
4.4.1.1 Vir
Za izvorni naslov so podprte naslednje kombinacije TON in NPI. Vse druge kombinacije bodo obravnavane kot neveljavne. Če je TON nastavljen na Neznano (0), bo uporabljen privzeti ukaz TON from bind. Če je NPI nastavljen na Neznano (0), bo uporabljen privzeti ukaz NPI from bind.
| TON | NPI | Opis |
| Alfanumerično (5) | Neznano (0) ISDN (1) |
Obravnavano bo kot alfanumerično besedilo pošiljatelja |
| Mednarodno (1) | Neznano (0) ISDN (1) |
Obravnavan bo kot MSISDN |
| Nacionalni (2) Številka naročnika, specifična za omrežje (3), številka naročnika (4). Skrajšano (6) |
Neznano (0) ISDN (1) Nacionalni (8) |
Obravnavana bo kot kratka številka, specifična za državo. |
4.4.1.2 Cilj
Za ciljni naslov so podprte naslednje kombinacije TON in NPI. Vse druge kombinacije bodo obravnavane kot neveljavne. Privzeti ukaz TON iz povezovanja bo uporabljen, če je TON nastavljen na Neznano (0). Privzeti NPI iz ukaza povezovanja bo uporabljen, če je NPI nastavljen na Neznano (0).
| TON | NPI | Opis |
| Mednarodno (1) | Neznano (0) ISDN (1) |
Obravnavan bo kot MSISDN |
4.4.2 Podprta kodiranja
Podprta so naslednja kodiranja. X lahko vsebuje katero koli vrednost.
| DCS | Kodiranje |
| 0xX0 | Privzeta abeceda GSM z razširitvijo |
| 0xX2 | 8-bitna dvojiška |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Presežena kvotaview
Kvota določa največje število sporočil SMS, ki jih je mogoče poslati v določenem časovnem intervalu (na primer na dan, teden, mesec ali za nedoločen čas). Vsaka kvota je enolično identificirana s kvotnim ID-jem (UUID) in se ponastavi glede na časovni pas stranke. Kvote je mogoče dodeliti na ravni države, regije ali privzete ravni prek storitve Quota Pro.fileKvoto je mogoče dinamično dodeliti tudi z uporabo preslikave kvot. To preslika nadrejeni QuotaId (UUID) in edinstven ključ kvote (npr. pošiljatelja ali uporabnika) na določen quotaId.
Kvota je določena v skladu z vašo lokalno podporo, dodeljenim upraviteljem računa ali privzeto, če ni nič določeno.
5.2 Stanje 106 – Kvota presežena
Sporočilo SMS je lahko blokirano s statusno kodo 106 (»količina presežena«), če:
- Sporočilo presega določeno omejitev za ustrezno kvoto znotraj trenutnega intervala.
- Ciljna država ali regija nima dodeljene kvote (tj. je eksplicitno blokirana z ničelno preslikavo kvote v programufile).
- Ni ujemajoče se kvote in ni določena privzeta kvota, kar povzroči zavrnitev.
V teh primerih sistem prepreči nadaljnjo obdelavo sporočil, da uveljavi omejitve, ki temeljijo na strankah ali destinacijah, in prepreči zlorabo.
Poročilo o dostavi
Podprta je le nobena ali končna dostava z uspešnim/neuspešnim rezultatom.
Oblika poročila o dostavi: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx datum opravljenega: llMMddHHmm stat:
Razpoložljive vrednosti v statusu:
- DELIVRD
- POTEKLO
- ZAVRNJENO
- RAZDEL
- IZBRISANO
6.1 Razširjena oblika poročila o dostavi
Razširjene informacije v poročilih o dostavi lahko zahtevate v stiku s svojim prodajnim predstavnikom.
Oblika poročila o dostavi: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 datum oddaje:
llMMddHHmm datum zaključka: llMMddHHmm stat: napaka: besedilo:
Razpoložljive vrednosti v statusu:
- DELIVRD
- POTEKLO
- ZAVRNJENO
- RAZDEL
- IZBRISANO
Polji »sub« in »dlvrd« bosta vedno nastavljeni na 000, polje »text« pa bo vedno prazno.
Glejte poglavje Kode napak za vrednosti za polje »err«.
Podprte različice TLS
TLS 1.2 ali TLS 1.3 je potreben za vse povezave TLS prek SMPP.
Podpora za TLS 1.0 in 1.1 je od 2020. novembra 11 ukinjena. Različici 15 in 1.0 TLS sta starejša protokola, ki sta bila opuščena in se v internetni skupnosti obravnavata kot varnostna tveganja.
LINK močno priporoča uporabo TLS, če se danes uporabljajo nešifrirane povezave SMPP. Nešifrirane povezave SMPP so od 2020. septembra 09 opuščene s strani LINK in bodo v prihodnosti odstranjene. Datum za odstranitev nešifriranih povezav še ni določen.
Povezave do strežnika SMPP za TLS so na vratih 3601 namesto nešifriranih na vratih 3600.
Še vedno lahko uporabljate TLS, tudi če vaša implementacija SMPP ne podpira TLS z uporabo stunnela, glejte https://www.stunnel.org/
Kode napak
Če je polje omogočeno, se lahko odgovori na naslednje kode napak v polju err.
| Koda napake | Opis |
| 0 | Neznana napaka |
| 1 | Začasna napaka pri usmerjanju |
| 2 | Trajna napaka pri usmerjanju |
| 3 | Največje dušenje je preseženo |
| 4 | Časovna omejitev |
| 5 | Neznana napaka operaterja |
| 6 | Napaka operaterja |
| 100 | Storitev ni najdena |
| 101 | Uporabnik ni bil najden |
| 102 | Račun ni bil najden |
| 103 | Neveljavno geslo |
| 104 | Napaka konfiguracije |
| 105 | Notranja napaka |
| 106 | Kvota presežena |
| 200 | OK |
| 1000 | Poslano |
| 1001 | Dostavljeno |
| 1002 | potekel |
| 1003 | Izbrisano |
| 1004 | Mobilni poln |
| 1005 | V čakalni vrsti |
| 1006 | Ni dostavljeno |
| 1007 | Dostavljeno, plačilo z zamudo |
| 1008 | Zaračunano, sporočilo ni poslano |
| 1009 | Zaračunano, sporočilo ni dostavljeno |
| 1010 | Potekel, odsotnost poročila operaterja o dostavi |
| 1011 | Zaračunano, sporočilo poslano (operaterju) |
| 1012 | Na daljavo v čakalni vrsti |
| 1013 | Sporočilo poslano operaterju, polnjenje zamujeno |
| 2000 | Neveljavna številka vira |
| 2001 | Kratka številka ni podprta kot vir |
| 2002 | Alfa ni podprta kot vir |
| 2003 | MSISDN ni podprt kot izvorna številka |
| 2100 | Kratka številka ni podprta kot cilj |
| 2101 | Alfa ni podprta kot cilj |
| 2102 | MSISDN ni podprt kot cilj |
| 2103 | Operacija blokirana |
| 2104 | Neznani naročnik |
| 2105 | Cilj blokiran |
| 2106 | Številčna napaka |
| 2107 | Cilj je začasno blokiran |
| 2108 | Neveljaven cilj |
| 2200 | Napaka pri polnjenju |
| 2201 | Naročnik ima nizko stanje |
|
2202 |
Naročnik je bil blokiran zaradi previsoke zaračunave (premium)
sporočila |
|
2203 |
Naročnik je premlad (za to posebno
vsebina) |
| 2204 | Predplačniški naročnik ni dovoljen |
| 2205 | Storitev je naročnik zavrnil |
| 2206 | Naročnik ni registriran v plačilnem sistemu |
| 2207 | Naročnik je dosegel največje stanje |
| 2208 | Potrebna je potrditev končnega uporabnika |
| 2300 | Povrnjeno |
|
2301 |
Vračilo ni bilo mogoče zaradi nezakonitega ali manjkajočega
MSISDN |
| 2302 | Zaradi manjkajočega ID-ja sporočila ni bilo mogoče vrniti |
| 2303 | V čakalni vrsti za vračilo |
| 2304 | Časovna omejitev vračila |
| 2305 | Vračilo ni uspelo |
| 3000 | GSM kodiranje ni podprto |
| 3001 | Kodiranje UCS2 ni podprto |
| 3002 | Binarno kodiranje ni podprto |
| 4000 | Poročilo o dostavi ni podprto |
| 4001 | Neveljavna vsebina sporočila |
| 4002 | Neveljavna tarifa |
| 4003 | Neveljavni uporabniški podatki |
| 4004 | Neveljavna glava uporabniških podatkov |
| 4005 | Neveljavno kodiranje podatkov |
| 4006 | Neveljaven DDV |
| 4007 | Nepodprta vsebina za cilj |
Dokumenti / Viri
 |
povezava mobilnost SMS API, SMPP API MS Scheduler API [pdf] Uporabniški priročnik SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |