SMS API, SMPP API MS Scheduler API
Brûkersgids
SMS API, SMPP API MS Scheduler API
| wizige: | 6/24/2025 |
| Ferzje: | 1.7 |
| Skriuwer: | Kenny Colander Norden, KCN |
Dit dokumint is allinich foar de oanwiisde ûntfanger en kin befoarrjochte, proprietêre of oars privee ynformaasje befetsje. As jo it fersin hawwe ûntfongen, asjebleaft de ôfstjoerder fuortendaliks ynformearje en it orizjineel wiskje. Elk oar gebrûk fan it dokumint troch jo is ferbean.
Skiednis feroarje
| Ds | Datum | By | Feroarings fan eardere release |
| 1.0 | 2010-03-16 | KCN | Oanmakke |
| 1. | 2019-06-11 | TPE | Updated LINK-logo's |
| 1. | 2019-09-27 | PNI | Referinsje tafoege oan SMPP 3.4-spesifikaasje |
| 1. | 2019-10-31 | EP | Observaasje oer de jildigensperioade tag |
| 1. | 2020-08-28 | KCN | Tafoege ynformaasje oangeande stipe TLS ferzjes |
| 2. | 2022-01-10 | KCN | Ekstra ynformaasje tafoege oangeande leveringsrapporten Bywurke ynformaasje oangeande TLS 1.3 |
| 2. | 2025-06-03 | GM | Resultaatkoade 2108 tafoege |
| 2. | 2025-06-24 | AK | Kwota tafoege |
Ynlieding
LINK Mobility is sûnt 2001 in SMS-distributeur en hat in protte ûnderfining yn it wurkjen mei sawol operators as ferbiningsaggregators. Dit platfoarm is ûntworpen om grutte ferkearsvoluminten te behanneljen, in hege beskikberens te behâlden en it maklik te meitsjen om ferkear fia meardere ferbiningen te routeren.
Dit dokumint beskriuwt de SMPP-ynterface foar it SMSC-platfoarm en hokker parameters en kommando's nedich binne en hokker parameters stipe wurde.
Dit dokumint sil gjin spesifike gebrûksgefallen behannelje lykas oaninoar keppele berjochten, WAPpush, Flash SMS, ensfh. Mear ynformaasje oer dy gefallen kin wurde krigen troch kontakt op te nimmen mei stipe.
Stipe kommando's
De tsjinner fan LINK Mobility moat wurde behannele as SMPP 3.4. De offisjele spesifikaasje is te finen op https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Alle metoaden wurde net stipe, en alle ferskillen wurde oantsjutte hjirûnder.
4.1 Bining
De folgjende bindopdrachten wurde stipe.
- Sender
- Transciever
- Untfanger
Fereaske parameters:
- system_id - krigen fan stipe
- wachtwurd - krigen fan stipe
Opsjonele parameters:
- addr_ton - standertwearde as TON is ynsteld op Unbekend by it yntsjinjen.
- addr_npi - standertwearde as NPI is ynsteld op Unbekend by it yntsjinjen.
Net-stipe parameters:
- adres_berik
4.2 Unbinde
It unbind kommando wurdt stipe.
4.3 Inquire keppeling
It kommando foar fraachkeppeling wurdt stipe en moat elke 60 sekonden oproppen wurde.
4.4 Yntsjinje
De yntsjinmetoade moat brûkt wurde foar it leverjen fan berjochten.
Fereaske parameters:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_kodearring
- sm_length
- koarte_berjocht
Net-stipe parameters:
- service_type
- protocol_id
- prioriteit_flagge
- skema_levertiid
- replace_if_present_flag
- sm_default_msg_id
Noat dat de lading tag wurdt net stipe en mar ien SMS kin wurde levere per oprop en it is oan te rieden dat de validity_period tag hat in wearde fan op syn minst 15 minuten lang.
4.4.1 Oanrikkemandearre TON en NPI
De folgjende TON en NPI moatte brûkt wurde by it ferstjoeren fan berjochten mei it kommando submit.
4.4.1.1 Boarne
De folgjende TON- en NPI-kombinaasjes wurde stipe foar boarneadres. Alle oare kombinaasjes wurde as ûnjildich behannele. It standert TON from bind-kommando sil brûkt wurde as TON ynsteld is op Unbekend (0). It standert NPI from bind-kommando sil brûkt wurde as NPI ynsteld is op Unbekend (0).
| TON | NPI | Beskriuwing |
| Alfanumeryk (5) | Unbekend (0) ISDN (1) |
Sil wurde behannele as alfanumerike stjoerdertekst |
| Ynternasjonaal (1) | Unbekend (0) ISDN (1) |
Sil wurde behannele as MSISDN |
| Nasjonale (2) Netwurkspesifyk (3) Abonneenûmer (4) Ofkoarte (6) |
Unbekend (0) ISDN (1) Nasjonale (8) |
Sil wurde behannele as lân spesifyk koarte nûmer. |
4.4.1.2 Bestimming
De folgjende TON- en NPI-kombinaasjes wurde stipe foar bestimmingsadres. Alle oare kombinaasjes wurde behannele as ûnjildich. It standert TON from bind kommando sil brûkt wurde as TON is ynsteld op Unbekend (0). De standert NPI fan binde kommando sil brûkt wurde as NPI is ynsteld op Unbekend (0).
| TON | NPI | Beskriuwing |
| Ynternasjonaal (1) | Unbekend (0) ISDN (1) |
Sil wurde behannele as MSISDN |
4.4.2 Stipe kodearrings
De folgjende kodearrings wurde stipe. X kin elke wearde befetsje.
| DCS | Kodearring |
| 0xx0 | Standert GSM Alfabet mei útwreiding |
| 0xx2 | 8-bit binêre |
| 0xx8 | UCS2 (ISO-10646-UCS-2) |
Kwota
5.1 Kwota oerview
In kwota definiearret it maksimale oantal SMS-berjochten dat binnen in bepaald tiidsynterval ferstjoerd wurde kin (lykas per dei, wike, moanne of foar ûnbepaalde tiid). Elk kwota wurdt unyk identifisearre troch in quotaId (UUID) en wurdt weromset neffens de tiidsône fan 'e klant. Kwota's kinne tawiisd wurde op lân-, regio- of standertnivo fia in Quota Pro.fileKwota kin ek dynamysk tawiisd wurde mei Quota Mapping. Dit wiist in âlderlike QuotaId (UUID) en in unike kwota-kaai (bygelyks, stjoerder of brûker) ta oan in spesifike kwotaId.
In kwota wurdt ynsteld yn oerienstimming mei jo lokale stipe, jo tawiisde akkountmanager of standert as neat oantsjutte is.
5.2 Status 106 – Kwota oerskreden
In SMS-berjocht kin blokkearre wurde mei statuskoade 106 ("kwota oerskreden") as:
- It berjocht giet oer de definieare limyt foar syn oerienkommende quotaId binnen it hjoeddeiske ynterval.
- It bestimmingslân of de bestimmingsregio hat gjin kwota tawiisd (d.w.s. is eksplisyt blokkearre mei in nul-kwota-mapping yn 'e profile).
- Der is gjin oerienkommende kwota en der is gjin standertkwota definiearre, wat resulteart yn ôfwizing.
Yn dizze gefallen foarkomt it systeem fierdere berjochtferwurking om klant- of bestimmingsbasearre limiten ôf te twingen en misbrûk te foarkommen.
Leverings Oersjoch
Allinich gjin of definitive levering mei súksesfol / mislearre resultaat wurde stipe.
Formaat op leveringsrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx diendatum: yyMMddHHmm stat:
Beskikbere wearden yn status:
- DELIVRD
- FERRIJD
- AFWIST
- UNDELIV
- WISKJE
6.1 Útwreide levering rapport opmaak
Utwreide ynformaasje yn leveringsrapporten kin oanfrege wurde yn kontakt mei jo ferkeapfertsjintwurdiger.
Formaat op leveringsrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 yntsjinnedatum:
jjMMddHHmm klear datum: jjMMddHHmm stat: flater: tekst:
Beskikbere wearden yn status:
- DELIVRD
- FERRIJD
- AFWIST
- UNDELIV
- WISKJE
"sub" en "dlvrd" fjilden sille altyd wurde ynsteld op 000, en "tekst" fjild sil altyd wêze leech.
Sjoch haadstik Flater koades foar wearden foar de "err" fjild.
Stipe TLS ferzjes
TLS 1.2 of TLS 1.3 is fereaske foar alle TLS-ferbiningen oer SMPP.
Stipe foar TLS 1.0 en 1.1 wurdt stopset sûnt 2020-11-15. Ferzjes 1.0 en 1.1 fan TLS binne âldere protokollen dy't ôfkard binne en wurde beskôge as feiligensrisiko's yn 'e ynternetmienskip.
LINK advisearje sterk om TLS te brûken as hjoeddedei net-fersifere SMPP-ferbiningen wurde brûkt. Net-fersifere SMPP-ferbiningen wurde ôfkard fanôf 2020-09-01 troch LINK, en sille yn 'e takomst fuortsmiten wurde. Datum foar it fuortheljen fan net-fersifere ferbiningen is noch net besletten.
Ferbinings nei de SMPP-tsjinner foar TLS binne op poarte 3601 ynstee fan net fersifere by poarte 3600.
Jo kinne TLS noch brûke, sels as jo SMPP-ymplemintaasje TLS net stipet mei stunnel, sjoch https://www.stunnel.org/
Flater koades
De folgjende flaterkoades kinne wurde beäntwurde yn it flaterfjild as it fjild ynskeakele is.
| Flater koade | Beskriuwing |
| 0 | Ûnbekende fout |
| 1 | Tydlike routing flater |
| 2 | Permaninte routing flater |
| 3 | Maksimum throttling overschreden |
| 4 | Skoft |
| 5 | Operator ûnbekende flater |
| 6 | Operator flater |
| 100 | Tsjinst net fûn |
| 101 | Brûker net fûn |
| 102 | Account net fûn |
| 103 | Unjildich Wachtwurd |
| 104 | Konfiguraasje flater |
| 105 | Ynterne flater |
| 106 | Kwota oerskreden |
| 200 | OK |
| 1000 | Ferstjoerd |
| 1001 | Levere |
| 1002 | Ferrûn |
| 1003 | Wiske |
| 1004 | Mobile fol |
| 1005 | Wachtrige |
| 1006 | Net levere |
| 1007 | Levere, lading fertrage |
| 1008 | Opladen, berjocht net ferstjoerd |
| 1009 | Opladen, berjocht net levere |
| 1010 | Ferrûn, ûntbrekken fan leveringsrapport fan operator |
| 1011 | Opladen, berjocht ferstjoerd (nei operator) |
| 1012 | Op ôfstân wachtrige |
| 1013 | Berjocht stjoerd nei operator, opladen fertrage |
| 2000 | Unjildich boarnenûmer |
| 2001 | Koarte nûmer wurdt net stipe as boarne |
| 2002 | Alpha wurdt net stipe as boarne |
| 2003 | MSISDN wurdt net stipe as boarne nûmer |
| 2100 | Koarte nûmer wurdt net stipe as bestimming |
| 2101 | Alpha wurdt net stipe as bestimming |
| 2102 | MSISDN wurdt net stipe as bestimming |
| 2103 | Operaasje blokkearre |
| 2104 | Unbekende abonnee |
| 2105 | Bestimming blokkearre |
| 2106 | Number flater |
| 2107 | Bestimming tydlik blokkearre |
| 2108 | Unjildige bestimming |
| 2200 | Opladen flater |
| 2201 | Abonnee hat leech saldo |
|
2202 |
Abonnee útsletten foar te folle yn rekken brocht (premium)
berjochten |
|
2203 |
Abonnee te jong (foar dit spesifike
ynhâld) |
| 2204 | Prepaid abonnee net tastien |
| 2205 | Tsjinst ôfwiisd troch abonnee |
| 2206 | Abonnee net registrearre yn betelling systeem |
| 2207 | De abonnee hat it maksimum saldo berikt |
| 2208 | Ein brûker befêstiging nedich |
| 2300 | Refundearre |
|
2301 |
Koe gjin jild weromjaan fanwegen yllegaal of ûntbrekkend
MSISDN |
| 2302 | Koe net werombetelje fanwegen ûntbrekkende messageId |
| 2303 | Wachtrige foar weromjefte |
| 2304 | Refund timeout |
| 2305 | Refund mislearring |
| 3000 | GSM-kodearring wurdt net stipe |
| 3001 | UCS2-kodearring wurdt net stipe |
| 3002 | Binêre kodearring wurdt net stipe |
| 4000 | Leveringsrapport wurdt net stipe |
| 4001 | Unjildige berjochtynhâld |
| 4002 | Unjildich taryf |
| 4003 | Unjildige brûkersgegevens |
| 4004 | Unjildige koptekst fan brûkersgegevens |
| 4005 | Unjildige gegevenskodearring |
| 4006 | Unjildige BTW |
| 4007 | Net-stipe ynhâld foar bestimming |
Dokuminten / Resources
 |
link mobiliteit SMS API, SMPP API MS Scheduler API [pdf] Brûkersgids SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |