SMS API, SMPP API MS Scheduler API
Brugervejledning
SMS API, SMPP API MS Scheduler API
| Ændret: | 6/24/2025 |
| Version: | 1.7 |
| Forfatter: | Kenny Colander Norden, KCN |
Dette dokument er kun for den udpegede modtager og kan indeholde privilegerede, proprietære eller på anden måde private oplysninger. Hvis du har modtaget den ved en fejl, bedes du straks underrette afsenderen og slette originalen. Enhver anden brug af dokumentet af dig er forbudt.
Skift historik
| Rev | Dato | By | Ændringer fra tidligere udgivelse |
| 1.0 | 2010-03-16 | KCN | Oprettet |
| 1. | 2019-06-11 | TPE | Opdaterede LINK-logoer |
| 1. | 2019-09-27 | PNI | Tilføjet reference til SMPP 3.4-specifikationen |
| 1. | 2019-10-31 | EP | Observation om gyldighedsperioden tag |
| 1. | 2020-08-28 | KCN | Tilføjet information vedrørende understøttede TLS-versioner |
| 2. | 2022-01-10 | KCN | Tilføjet yderligere oplysninger vedrørende leveringsrapporter Opdaterede oplysninger vedrørende TLS 1.3 |
| 2. | 2025-06-03 | GM | Tilføjet resultatkode 2108 |
| 2. | 2025-06-24 | AK | Tilføjet kvote |
Indledning
LINK Mobility har været SMS-distributør siden 2001 og har stor erfaring med at arbejde med både operatører og forbindelsesaggregatorer. Denne platform er designet til at håndtere store trafikmængder, opretholde en høj tilgængelighed og gøre det nemt at dirigere trafik via flere forbindelser.
Dette dokument beskriver SMPP-grænsefladen til SMSC-platformen, og hvilke parametre og kommandoer der kræves, samt hvilke parametre der understøttes.
Dette dokument vil ikke håndtere specifikke brugsscenarier som sammenkædede beskeder, WAPpush, Flash SMS osv. Du kan få flere oplysninger om disse scenarier ved at kontakte support.
Understøttede kommandoer
LINK Mobilitys server skal behandles som SMPP 3.4. Den officielle specifikation kan findes på https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Alle metoder er ikke understøttet, og alle forskelle er specificeret nedenfor.
4.1 Bind
Følgende bindekommandoer understøttes.
- Sender
- Transciever
- Modtager
Påkrævede parametre:
- system_id – hentet fra support
- adgangskode – hentet fra support
Valgfri parametre:
- addr_ton – standardværdi, hvis TON er sat til Ukendt under indsendelse.
- addr_npi – standardværdi, hvis NPI er sat til Ukendt under indsendelse.
Ikke-understøttede parametre:
- adresseområde
4.2 Afbind
Unbind-kommandoen understøttes.
4.3 Forespørgselslink
Forespørgselslink-kommandoen understøttes og bør kaldes hvert 60. sekund.
4.4 Indsend
Indsendelsesmetoden skal bruges til at levere beskeder.
Påkrævede parametre:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_klasse
- data_kodning
- sm_længde
- kort_besked
Ikke-understøttede parametre:
- service_type
- protokol_id
- priority_flag
- plan_leveringstid
- replace_if_present_flag
- sm_default_msg_id
Note at nyttelasten tag er ikke understøttet, og der må kun leveres én SMS pr. opkald, og det anbefales, at validity_period tag har en værdi på mindst 15 minutter lang.
4.4.1 Anbefalet TON og NPI
Følgende TON og NPI skal bruges, når der sendes meddelelser med submit-kommando.
4.4.1.1 Kilde
Følgende TON- og NPI-kombinationer understøttes for kildeadresse. Alle andre kombinationer vil blive behandlet som ugyldige. Standardkommandoen TON from bind vil blive brugt, hvis TON er indstillet til Ukendt (0). Standardkommandoen NPI from bind vil blive brugt, hvis NPI er indstillet til Ukendt (0).
| TON | NPI | Beskrivelse |
| Alfanumerisk (5) | Ukendt (0) ISDN (1) |
Vil blive behandlet som alfanumerisk afsendertekst |
| International (1) | Ukendt (0) ISDN (1) |
Vil blive behandlet som MSISDN |
| National (2) Netværksspecifik (3) Abonnentnummer (4) Forkortet (6) |
Ukendt (0) ISDN (1) National (8) |
Vil blive behandlet som et landespecifikt kortnummer. |
4.4.1.2 Destination
Følgende TON- og NPI-kombinationer understøttes for destinationsadresse. Alle andre kombinationer vil blive behandlet som ugyldige. Standardkommandoen TON fra bind vil blive brugt, hvis TON er sat til Ukendt (0). Standard NPI fra bind-kommandoen vil blive brugt, hvis NPI er indstillet til Ukendt (0).
| TON | NPI | Beskrivelse |
| International (1) | Ukendt (0) ISDN (1) |
Vil blive behandlet som MSISDN |
4.4.2 Understøttede kodninger
Følgende kodninger understøttes. X kan indeholde en hvilken som helst værdi.
| DCS | Kodning |
| 0xX0 | Standard GSM-alfabet med udvidelse |
| 0xX2 | 8-bit binær |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Kvote overskredetview
En kvote definerer det maksimale antal SMS-beskeder, der kan sendes inden for et bestemt tidsinterval (f.eks. pr. dag, uge, måned eller på ubestemt tid). Hver kvote er unikt identificeret af et kvota-ID (UUID) og nulstilles i henhold til kundens tidszone. Kvoter kan tildeles på lande-, regions- eller standardniveau via en Quota Pro.fileKvote kan også tildeles dynamisk ved hjælp af kvotekortlægning. Dette knytter et overordnet kvota-id (UUID) og en unik kvotenøgle (f.eks. afsender eller bruger) til et specifikt kvota-id.
En kvote fastsættes i overensstemmelse med din lokale support, din tildelte account manager eller som standard, hvis intet er angivet.
5.2 Status 106 – Kvote overskredet
En SMS-besked kan blive blokeret med statuskode 106 (“kvote overskredet”), når:
- Meddelelsen overskrider den definerede grænse for dens tilsvarende kvota-ID inden for det aktuelle interval.
- Destinationslandet eller -regionen har ingen tildelt kvote (dvs. er eksplicit blokeret med en nullkvote-tilknytning i pro'en).file).
- Der er ingen matchende kvote, og der er ikke defineret nogen standardkvote, hvilket resulterer i afvisning.
I disse tilfælde forhindrer systemet yderligere meddelelsesbehandling for at håndhæve kunde- eller destinationsbaserede grænser og undgå misbrug.
Leveringsrapport
Kun ingen eller endelig levering med succesfuldt/mislykket resultat understøttes.
Format på leveringsrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx færdigdato: ååMMddHHmm stat:
Tilgængelige værdier i status:
- DELIVRD
- UDLØB
- AFVISET
- UDELIV
- SLETTET
6.1 Udvidet leveringsrapportformat
Udvidede oplysninger i leveringsrapporter kan anmodes om i kontakt med din salgsrepræsentant.
Format på leveringsrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 indsendelsesdato:
ååMMddHHmm færdig dato: ååMMddHHmm stat: fejl: tekst:
Tilgængelige værdier i status:
- DELIVRD
- UDLØB
- AFVISET
- UDELIV
- SLETTET
"sub" og "dlvrd" felter vil altid være sat til 000, og "text" felt vil altid være tomt.
Se kapitlet Fejlkoder for værdier for "err"-feltet.
Understøttede TLS-versioner
TLS 1.2 eller TLS 1.3 er påkrævet for alle TLS-forbindelser over SMPP.
Support til TLS 1.0 og 1.1 er afbrudt siden 2020-11-15. Version 1.0 og 1.1 af TLS er ældre protokoller, der er blevet forældet og betragtes som sikkerhedsrisici i internetfællesskabet.
LINK anbefaler på det kraftigste at bruge TLS, hvis der bruges ukrypterede SMPP-forbindelser i dag. Ukrypterede SMPP-forbindelser er udfaset fra 2020-09-01 af LINK og vil blive fjernet i fremtiden. Dato for fjernelse af ukrypterede forbindelser er endnu ikke besluttet.
Forbindelser til SMPP-serveren til TLS er ved port 3601 i stedet for ukrypteret ved port 3600.
Du kan stadig bruge TLS, selvom din SMPP-implementering ikke understøtter TLS ved hjælp af stunnel, se https://www.stunnel.org/
Fejlkoder
Følgende fejlkoder kan blive besvaret i fejlfeltet, hvis feltet er aktiveret.
| Fejlkode | Beskrivelse |
| 0 | Ukendt fejl |
| 1 | Midlertidig routingfejl |
| 2 | Permanent routing fejl |
| 3 | Maksimal drosling overskredet |
| 4 | Timeout |
| 5 | Operatør ukendt fejl |
| 6 | Operatør fejl |
| 100 | Tjenesten blev ikke fundet |
| 101 | Bruger ikke fundet |
| 102 | Konto ikke fundet |
| 103 | Forkert kodeord |
| 104 | Konfigurationsfejl |
| 105 | Intern fejl |
| 106 | Kvote overskredet |
| 200 | OK |
| 1000 | Sendt |
| 1001 | Leveret |
| 1002 | Udløbet |
| 1003 | Slettet |
| 1004 | Mobil fuld |
| 1005 | I kø |
| 1006 | Ikke leveret |
| 1007 | Leveret, opladning forsinket |
| 1008 | Opkrævet, besked ikke sendt |
| 1009 | Opkrævet, besked ikke leveret |
| 1010 | Udløbet, fravær af operatørleveringsrapport |
| 1011 | Opkrævet, besked sendt (til operatør) |
| 1012 | Fjernt i kø |
| 1013 | Besked sendt til operatør, opladning forsinket |
| 2000 | Ugyldigt kildenummer |
| 2001 | Kort nummer understøttes ikke som kilde |
| 2002 | Alfa er ikke understøttet som kilde |
| 2003 | MSISDN understøttes ikke som kildenummer |
| 2100 | Kort nummer understøttes ikke som destination |
| 2101 | Alfa understøttes ikke som destination |
| 2102 | MSISDN understøttes ikke som destination |
| 2103 | Operation blokeret |
| 2104 | Ukendt abonnent |
| 2105 | Destination blokeret |
| 2106 | Nummerfejl |
| 2107 | Destination midlertidigt blokeret |
| 2108 | Ugyldig destination |
| 2200 | Opladningsfejl |
| 2201 | Abonnenten har lav saldo |
|
2202 |
Abonnent udelukket for overopkrævet betaling (premium)
beskeder |
|
2203 |
Abonnenten er for ung (til denne specifikke situation)
indhold) |
| 2204 | Forudbetalt abonnent er ikke tilladt |
| 2205 | Service afvist af abonnent |
| 2206 | Abonnent ikke registreret i betalingssystemet |
| 2207 | Abonnenten har nået maks. saldo |
| 2208 | Slutbrugerbekræftelse påkrævet |
| 2300 | Refunderet |
|
2301 |
Kunne ikke refundere på grund af ulovligt eller manglende
MSISDN |
| 2302 | Kunne ikke refundere på grund af manglende besked-id |
| 2303 | I kø for refusion |
| 2304 | Timeout for tilbagebetaling |
| 2305 | Refusionsfejl |
| 3000 | GSM-kodning understøttes ikke |
| 3001 | UCS2-kodning understøttes ikke |
| 3002 | Binær kodning understøttes ikke |
| 4000 | Leveringsrapport understøttes ikke |
| 4001 | Ugyldigt beskedindhold |
| 4002 | Ugyldig takst |
| 4003 | Ugyldige brugerdata |
| 4004 | Ugyldig brugerdataheader |
| 4005 | Ugyldig datakodning |
| 4006 | Ugyldig moms |
| 4007 | Ikke-understøttet indhold til destination |
Dokumenter/ressourcer
 |
link mobility SMS API, SMPP API MS Scheduler API [pdfBrugervejledning SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |