SMS-API, SMPP-API MS Scheduler-API
Gebruikershandleiding
SMS-API, SMPP-API MS Scheduler-API
| Gewijzigd: | 6/24/2025 |
| Versie: | 1.7 |
| Auteur: | Kenny Colander Norden, KCN |
Dit document is alleen voor de aangewezen ontvanger en kan bevoorrechte, bedrijfseigen of anderszins persoonlijke informatie bevatten. Als u het per vergissing heeft ontvangen, stel de afzender dan onmiddellijk op de hoogte en verwijder het origineel. Elk ander gebruik van het document door u is verboden.
Wijzigingsgeschiedenis
| Rev | Datum | By | Wijzigingen ten opzichte van vorige release |
| 1.0 | 2010-03-16 | KCN | Gemaakt |
| 1. | 2019-06-11 | TPE | Bijgewerkte LINK-logo's |
| 1. | 2019-09-27 | PNI | Verwijzing naar SMPP 3.4-specificatie toegevoegd |
| 1. | 2019-10-31 | EP | Opmerking over de geldigheidsduur tag |
| 1. | 2020-08-28 | KCN | Informatie toegevoegd over ondersteunde TLS-versies |
| 2. | 2022-01-10 | KCN | Extra informatie toegevoegd met betrekking tot leveringsrapporten Bijgewerkte informatie over TLS 1.3 |
| 2. | 2025-06-03 | GM | Resultaatcode 2108 toegevoegd |
| 2. | 2025-06-24 | AK | Toegevoegd quotum |
Invoering
LINK Mobility is sinds 2001 SMS-distributeur en heeft veel ervaring in het werken met zowel operators als verbindingsaggregators. Dit platform is ontworpen om grote verkeersvolumes te verwerken, een hoge beschikbaarheid te behouden en het gemakkelijk te maken om verkeer via meerdere verbindingen te routeren.
In dit document wordt de SMPP-interface naar het SMSC-platform beschreven, evenals welke parameters en opdrachten vereist zijn en welke parameters worden ondersteund.
In dit document worden geen specifieke use cases behandeld, zoals aaneengeschakelde berichten, WAPpush, Flash SMS, enz. Voor meer informatie over deze cases kunt u contact opnemen met de ondersteuning.
Ondersteunde opdrachten
De server van LINK Mobility moet worden behandeld als SMPP 3.4. De officiële specificatie is te vinden op https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Niet alle methoden worden ondersteund en alle verschillen worden hieronder vermeld.
4.1 Binden
De volgende bindopdrachten worden ondersteund.
- Zender
- zendontvanger
- Ontvanger
Vereiste parameters:
- system_id - verkregen van ondersteuning
- wachtwoord – verkregen van ondersteuning
Facultatieve parameters:
- addr_ton – standaardwaarde als TON is ingesteld op Onbekend tijdens het verzenden.
- addr_npi – standaardwaarde als NPI is ingesteld op Onbekend tijdens het indienen.
Niet-ondersteunde parameters:
- adresbereik
4.2 Ontbinden
De opdracht unbind wordt ondersteund.
4.3 Informeer link
Het commando Inquire Link wordt ondersteund en moet elke 60 seconden worden aangeroepen.
4.4 Verzenden
De verzendmethode moet worden gebruikt voor het bezorgen van berichten.
Vereiste parameters:
- bron_addr_ton
- bron_addr_npi
- bron_addr
- beste_addr_ton
- beste_addr_npi
- beste_addr
- esm_klasse
- gegevens_codering
- sm_lengte
- kort bericht
Niet-ondersteunde parameters:
- Dienst Type
- protocol_id
- prioriteit_vlag
- planning_bezorgtijd
- vervang_indien_aanwezige_vlag
- sm_default_msg_id
Opmerking dat de lading tag wordt niet ondersteund en er mag slechts één sms per oproep worden afgeleverd en het wordt aanbevolen om de geldigheid_periode tag heeft een waarde van minimaal 15 minuten.
4.4.1 Aanbevolen TON en NPI
De volgende TON en NPI moeten worden gebruikt bij het verzenden van berichten met de opdracht Verzenden.
4.4.1.1 Bron
De volgende TON- en NPI-combinaties worden ondersteund voor het bronadres. Alle andere combinaties worden als ongeldig beschouwd. De standaard TON van de bindopdracht wordt gebruikt als TON is ingesteld op Onbekend (0). De standaard NPI van de bindopdracht wordt gebruikt als NPI is ingesteld op Onbekend (0).
| TON | NPI | Beschrijving |
| Alfanumeriek (5) | Onbekend (0) ISDN (1) |
Wordt behandeld als alfanumerieke afzendertekst |
| Internationaal (1) | Onbekend (0) ISDN (1) |
Wordt behandeld als MSISDN |
| Nationaal (2) Netwerkspecifiek (3) Abonneenummer (4) Afgekort (6) |
Onbekend (0) ISDN (1) Nationaal (8) |
Wordt behandeld als landspecifiek verkort nummer. |
4.4.1.2 Bestemming
De volgende TON- en NPI-combinaties worden ondersteund voor het bestemmingsadres. Alle andere combinaties worden als ongeldig beschouwd. De standaard TON van de opdracht bind wordt gebruikt als TON is ingesteld op Onbekend (0). De standaard NPI van de opdracht bind wordt gebruikt als NPI is ingesteld op Onbekend (0).
| TON | NPI | Beschrijving |
| Internationaal (1) | Onbekend (0) ISDN (1) |
Wordt behandeld als MSISDN |
4.4.2 Ondersteunde coderingen
De volgende coderingen worden ondersteund. X kan elke waarde bevatten.
| DCS | Codering |
| 0xX0 | Standaard GSM-alfabet met extensie |
| 0xX2 | 8-bits binair |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quotum
5.1 Quotum overschredenview
Een quotum definieert het maximale aantal sms-berichten dat binnen een bepaald tijdsinterval (bijvoorbeeld per dag, week, maand of voor onbepaalde tijd) kan worden verzonden. Elk quotum wordt uniek geïdentificeerd door een quota-ID (UUID) en wordt gereset op basis van de tijdzone van de klant. Quota's kunnen worden toegewezen op land-, regio- of standaardniveau via een Quota Pro.fileQuota kan ook dynamisch worden toegewezen met behulp van Quota Mapping. Hierbij worden een bovenliggende QuotaId (UUID) en een unieke quotasleutel (bijv. afzender of gebruiker) gekoppeld aan een specifieke quotaId.
Er wordt een quotum vastgesteld in overleg met uw lokale ondersteuning, uw toegewezen accountmanager of standaard als er niets is opgegeven.
5.2 Status 106 – Quota overschreden
Een sms-bericht kan worden geblokkeerd met statuscode 106 (“quotum overschreden”) wanneer:
- Het bericht overschrijdt de gedefinieerde limiet voor de bijbehorende quotaId binnen het huidige interval.
- Aan het land of de regio van bestemming is geen quotum toegewezen (d.w.z. het is expliciet geblokkeerd met een toewijzing van een quotum van nul in de profile).
- Er is geen overeenkomend quotum en er is geen standaardquotum gedefinieerd, wat leidt tot afwijzing.
In deze gevallen voorkomt het systeem verdere berichtverwerking om limieten op basis van de klant of bestemming af te dwingen en misbruik te voorkomen.
Afleveringsrapport
Alleen geen of definitieve levering met succesvol/mislukt resultaat wordt ondersteund.
Formaat op afleverrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx gedaan datum: jjMMddHHmm stat:
Beschikbare waarden in status:
- LEVEREN
- VERLOPEN
- AFGEWEZEN
- ONTBINDEN
- VERWIJDERD
6.1 Uitgebreid opleverrapportformaat
Uitgebreide informatie in leveringsrapporten kan worden opgevraagd in contact met uw verkoopvertegenwoordiger.
Formaat op leveringsrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 indiendatum:
jjMMddHHmm gedaan datum: jjMMddHHmm stat: fout: tekst:
Beschikbare waarden in status:
- LEVEREN
- VERLOPEN
- AFGEWEZEN
- ONTBINDEN
- VERWIJDERD
De velden "sub" en "dlvrd" zijn altijd ingesteld op 000 en het veld "tekst" is altijd leeg.
Zie het hoofdstuk Foutcodes voor waarden voor het veld "err".
Ondersteunde TLS-versies
TLS 1.2 of TLS 1.3 is vereist voor alle TLS-verbindingen via SMPP.
Ondersteuning voor TLS 1.0 en 1.1 wordt stopgezet sinds 2020-11-15. Versies 1.0 en 1.1 van TLS zijn oudere protocollen die zijn verouderd en worden beschouwd als beveiligingsrisico's in de internetgemeenschap.
LINK raadt ten zeerste aan om TLS te gebruiken als momenteel niet-versleutelde SMPP-verbindingen worden gebruikt. Niet-versleutelde SMPP-verbindingen worden per 2020-09-01 door LINK afgeschaft en zullen in de toekomst worden verwijderd. Datum voor het verwijderen van niet-versleutelde verbindingen is nog niet beslist.
Verbindingen naar de SMPP-server voor TLS zijn op poort 3601 in plaats van onversleuteld op poort 3600.
U kunt TLS nog steeds gebruiken, zelfs als uw SMPP-implementatie TLS met behulp van stunnel niet ondersteunt, zie https://www.stunnel.org/
Foutcodes
De volgende foutcodes kunnen worden beantwoord in het err-veld als het veld is ingeschakeld.
| Foutcode | Beschrijving |
| 0 | Onbekende fout |
| 1 | Tijdelijke routeringsfout |
| 2 | Permanente routeringsfout |
| 3 | Maximale beperking overschreden |
| 4 | Time-out |
| 5 | Operator onbekende fout |
| 6 | Fout van de operator |
| 100 | Service niet gevonden |
| 101 | Gebruiker niet gevonden |
| 102 | Account niet gevonden |
| 103 | Ongeldig wachtwoord |
| 104 | Configuratiefout |
| 105 | Interne fout |
| 106 | Quota overschreden |
| 200 | OK |
| 1000 | Verstuurd |
| 1001 | Afgeleverd |
| 1002 | Verlopen |
| 1003 | Verwijderd |
| 1004 | Mobiel vol |
| 1005 | In de wachtrij |
| 1006 | Niet geleverd |
| 1007 | Geleverd, opladen vertraagd |
| 1008 | In rekening gebracht, bericht niet verzonden |
| 1009 | In rekening gebracht, bericht niet afgeleverd |
| 1010 | Verlopen, geen afleverrapport van de operator |
| 1011 | In rekening gebracht, bericht verzonden (naar operator) |
| 1012 | Op afstand in de wachtrij |
| 1013 | Bericht verzonden naar operator, opladen vertraagd |
| 2000 | Ongeldig bronnummer |
| 2001 | Kort nummer wordt niet ondersteund als bron |
| 2002 | Alfa wordt niet ondersteund als bron |
| 2003 | MSISDN wordt niet ondersteund als bronnummer |
| 2100 | Kort nummer wordt niet ondersteund als bestemming |
| 2101 | Alfa wordt niet ondersteund als bestemming |
| 2102 | MSISDN wordt niet ondersteund als bestemming |
| 2103 | Bediening geblokkeerd |
| 2104 | Onbekende abonnee |
| 2105 | Bestemming geblokkeerd |
| 2106 | Aantal fout |
| 2107 | Bestemming tijdelijk geblokkeerd |
| 2108 | Ongeldige bestemming |
| 2200 | Fout bij het opladen |
| 2201 | Abonnee heeft een laag saldo |
|
2202 |
Abonnee uitgesloten vanwege te veel betaald (premium)
berichten |
|
2203 |
Abonnee te jong (voor deze specifieke
inhoud) |
| 2204 | Prepaid abonnee niet toegestaan |
| 2205 | Service afgewezen door abonnee |
| 2206 | Abonnee niet geregistreerd in betalingssysteem |
| 2207 | Abonnee heeft maximaal saldo bereikt |
| 2208 | Bevestiging van eindgebruiker vereist |
| 2300 | Terugbetaald |
|
2301 |
Kon niet terugbetalen vanwege illegale of ontbrekende
MSISDN |
| 2302 | Kan niet terugbetalen vanwege ontbrekende messageId |
| 2303 | In de wachtrij geplaatst voor terugbetaling |
| 2304 | Terugbetaling time-out |
| 2305 | Terugbetaling mislukt |
| 3000 | GSM-codering wordt niet ondersteund |
| 3001 | UCS2-codering wordt niet ondersteund |
| 3002 | Binaire codering wordt niet ondersteund |
| 4000 | Leveringsrapport wordt niet ondersteund |
| 4001 | Ongeldige berichtinhoud |
| 4002 | Ongeldig tarief |
| 4003 | Ongeldige gebruikersgegevens |
| 4004 | Ongeldige gebruikersgegevenskop |
| 4005 | Ongeldige gegevenscodering |
| 4006 | Ongeldige BTW |
| 4007 | Niet-ondersteunde inhoud voor bestemming |
Documenten / Bronnen
 |
linkmobiliteit SMS API,SMPP API MS Scheduler API [pdf] Gebruikershandleiding SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |