SMS API, SMPP API MS Scheduler API
Användarhandbok
SMS API, SMPP API MS Scheduler API
| Ändrad: | 6/24/2025 |
| Version: | 1.7 |
| Författare: | Kenny Colander Norden, KCN |
Detta dokument är endast till för den utsedda mottagaren och kan innehålla privilegierad, proprietär eller på annat sätt privat information. Om du har fått det av misstag, vänligen meddela avsändaren omedelbart och radera originalet. All annan användning av dokumentet av dig är förbjuden.
Ändringshistorik
| Varv | Datum | By | Ändringar från tidigare utgåva |
| 1.0 | 2010-03-16 | KCN | Skapad |
| 1. | 2019-06-11 | TPE | Uppdaterade LINK-logotyper |
| 1. | 2019-09-27 | PNI | Lade till referens till SMPP 3.4-specifikationen |
| 1. | 2019-10-31 | EP | Observation om giltighetstiden tag |
| 1. | 2020-08-28 | KCN | Lade till information om TLS-versioner som stöds |
| 2. | 2022-01-10 | KCN | Lade till ytterligare information om leveransrapporter Uppdaterad information om TLS 1.3 |
| 2. | 2025-06-03 | GM | Lade till resultatkod 2108 |
| 2. | 2025-06-24 | AK | Tillagd kvot |
Introduktion
LINK Mobility har varit SMS-distributör sedan 2001 och har stor erfarenhet av att arbeta med både operatörer och anslutningsaggregatorer. Denna plattform är designad för att hantera stora trafikvolymer, upprätthålla en hög tillgänglighet och göra det enkelt att dirigera trafik via flera anslutningar.
Detta dokument beskriver SMPP-gränssnittet till SMSC-plattformen och vilka parametrar och kommandon som krävs och vilka parametrar som stöds.
Detta dokument kommer inte att hantera specifika användningsfall som sammanfogade meddelanden, WAPpush, Flash SMS etc. Mer information om dessa fall kan fås genom att kontakta supporten.
Kommandon som stöds
LINK Mobilitys server ska behandlas som SMPP 3.4. Den officiella specifikationen finns på https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Alla metoder stöds inte, och alla skillnader anges nedan.
4.1 Bind
Följande bindningskommandon stöds.
- Sändare
- transciever
- Mottagare
Obligatoriska parametrar:
- system_id – hämtat från support
- lösenord – fås från support
Valfria parametrar:
- addr_ton – standardvärde om TON är inställt på Okänt under inlämning.
- addr_npi – standardvärde om NPI är inställt på Okänt under inlämning.
Parametrar som inte stöds:
- adressintervall
4.2 Avbinda
Kommandot unbind stöds.
4.3 Fråga länk
Kommandot förfrågningslänk stöds och bör anropas var 60:e sekund.
4.4 Skicka in
Inlämningsmetoden ska användas för att leverera meddelanden.
Obligatoriska parametrar:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_längd
- kort meddelande
Parametrar som inte stöds:
- service_type
- protocol_id
- priority_flagga
- schema_leveranstid
- replace_if_present_flag
- sm_default_msg_id
Notera att nyttolasten tag stöds inte och endast ett SMS får levereras per samtal och det rekommenderas att validity_period tag har ett värde på minst 15 minuter långt.
4.4.1 Rekommenderad TON och NPI
Följande TON och NPI ska användas när du skickar meddelanden med kommandot submit.
4.4.1.1 Källa
Följande TON- och NPI-kombinationer stöds för källadresser. Alla andra kombinationer kommer att behandlas som ogiltiga. Standardkommandot TON from bind används om TON är inställt på Okänt (0). Standardkommandot NPI from bind används om NPI är inställt på Okänt (0).
| TON | NPI | Beskrivning |
| Alfanumerisk (5) | Okänd (0) ISDN (1) |
Kommer att behandlas som alfanumerisk avsändartext |
| Internationell (1) | Okänd (0) ISDN (1) |
Kommer att behandlas som MSISDN |
| Nationellt (2) Nätverksspecifik (3) Prenumerantnummer (4) Förkortad (6) |
Okänd (0) ISDN (1) Nationellt (8) |
Kommer att behandlas som landsspecifikt kortnummer. |
4.4.1.2 Destination
Följande TON- och NPI-kombinationer stöds för destinationsadresser. Alla andra kombinationer kommer att behandlas som ogiltiga. Standardkommandot TON från bind kommer att användas om TON är inställt på Okänd (0). Standardkommandot för NPI från bindning kommer att användas om NPI är inställt på Okänd (0).
| TON | NPI | Beskrivning |
| Internationell (1) | Okänd (0) ISDN (1) |
Kommer att behandlas som MSISDN |
4.4.2 Kodningar som stöds
Följande kodningar stöds. X kan innehålla vilket värde som helst.
| DCS | Kodning |
| 0xX0 | Standard GSM-alfabet med tillägg |
| 0xX2 | 8-bitars binär |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvot
5.1 Kvot överview
En kvot definierar det maximala antalet SMS-meddelanden som kan skickas inom ett visst tidsintervall (t.ex. per dag, vecka, månad eller på obestämd tid). Varje kvot identifieras unikt med ett kvot-ID (UUID) och återställs enligt kundens tidszon. Kvoter kan tilldelas på lands-, regions- eller standardnivå via en Quota Pro.fileKvoter kan också tilldelas dynamiskt med hjälp av kvotmappning. Detta mappar ett överordnat kvota-ID (UUID) och en unik kvotnyckel (t.ex. avsändare eller användare) till ett specifikt kvota-ID.
En kvot sätts i enlighet med din lokala support, din tilldelade kontoansvarige eller som standard om inget anges.
5.2 Status 106 – Kvot överskriden
Ett SMS-meddelande kan blockeras med statuskod 106 (”kvot överskriden”) när:
- Meddelandet överskrider den definierade gränsen för motsvarande kvot-ID inom det aktuella intervallet.
- Destinationslandet eller -regionen har ingen tilldelad kvot (dvs. är explicit blockerad med en nullkvotmappning i profile).
- Det finns ingen matchande kvot och ingen standardkvot är definierad, vilket resulterar i avslag.
I dessa fall förhindrar systemet ytterligare meddelandebehandling för att upprätthålla kund- eller destinationsbaserade gränser och undvika missbruk.
Leveransrapport
Endast ingen eller slutlig leverans med framgångsrikt/misslyckat resultat stöds.
Format på leveransrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx gjort datum: ååMMddHHmm stat:
Tillgängliga värden i status:
- DELIVRD
- UTGÅTT
- AVVISAD
- UNDELIV
- RADERAD
6.1 Utökat leveransrapportformat
Utökad information i leveransrapporter kan begäras i kontakt med din säljare.
Format på leveransrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 inlämningsdatum:
ååMMddHHmm klart datum: ååMMddHHmm stat: fela: text:
Tillgängliga värden i status:
- DELIVRD
- UTGÅTT
- AVVISAD
- UNDELIV
- RADERAD
"sub" och "dlvrd"-fält kommer alltid att vara inställda på 000, och "text"-fält kommer alltid att vara tomt.
Se kapitlet Felkoder för värden för fältet "err".
TLS-versioner som stöds
TLS 1.2 eller TLS 1.3 krävs för alla TLS-anslutningar över SMPP.
Stödet för TLS 1.0 och 1.1 har upphört sedan 2020-11-15. Versioner 1.0 och 1.1 av TLS är äldre protokoll som har föråldrats och anses vara säkerhetsrisker i Internetgemenskapen.
LINK rekommenderar starkt att använda TLS om okrypterade SMPP-anslutningar används idag. Okrypterade SMPP-anslutningar fasas ut från och med 2020-09-01 av LINK och kommer att tas bort i framtiden. Datum för borttagning av okrypterade anslutningar är inte bestämt ännu.
Anslutningar till SMPP-servern för TLS är vid port 3601 istället för okrypterade vid port 3600.
Du kan fortfarande använda TLS även om din SMPP-implementering inte stöder TLS med hjälp av stunnel, se https://www.stunnel.org/
Felkoder
Följande felkoder kan besvaras i felfältet om fältet är aktiverat.
| Felkod | Beskrivning |
| 0 | Okänt fel |
| 1 | Tillfälligt routingfel |
| 2 | Permanent routingfel |
| 3 | Maximal strypning har överskridits |
| 4 | Timeout |
| 5 | Operatör okänt fel |
| 6 | Operatörsfel |
| 100 | Tjänsten hittades inte |
| 101 | Användaren hittades inte |
| 102 | konto inte funnet |
| 103 | Felaktigt lösenord |
| 104 | Konfigurationsfel |
| 105 | Internt fel |
| 106 | Kvoten har överskridits |
| 200 | OK |
| 1000 | Skickat |
| 1001 | Levereras |
| 1002 | Utgått |
| 1003 | Raderad |
| 1004 | Mobilen full |
| 1005 | I kö |
| 1006 | Ej levererad |
| 1007 | Levereras, laddning försenad |
| 1008 | Debiterad, meddelande har inte skickats |
| 1009 | Laddat, meddelande har inte levererats |
| 1010 | Utgått, frånvaro av operatörens leveransrapport |
| 1011 | Debiterad, meddelande skickat (till operatör) |
| 1012 | Fjärrkö |
| 1013 | Meddelande skickat till operatören, laddning försenad |
| 2000 | Ogiltigt källnummer |
| 2001 | Kort nummer stöds inte som källa |
| 2002 | Alpha stöds inte som källa |
| 2003 | MSISDN stöds inte som källnummer |
| 2100 | Kort nummer stöds inte som destination |
| 2101 | Alfa stöds inte som destination |
| 2102 | MSISDN stöds inte som destination |
| 2103 | Operation blockerad |
| 2104 | Okänd prenumerant |
| 2105 | Destination blockerad |
| 2106 | Nummerfel |
| 2107 | Destinationen tillfälligt blockerad |
| 2108 | Ogiltig destination |
| 2200 | Laddningsfel |
| 2201 | Prenumeranten har lågt saldo |
|
2202 |
Prenumerant avstängd för överdebitering (premium)
meddelanden |
|
2203 |
Prenumeranten är för ung (för just detta)
innehåll) |
| 2204 | Prepaid-abonnent är inte tillåtet |
| 2205 | Tjänsten avvisad av abonnenten |
| 2206 | Prenumerant inte registrerad i betalningssystemet |
| 2207 | Prenumeranten har nått maxsaldo |
| 2208 | Slutanvändarbekräftelse krävs |
| 2300 | Återbetalas |
|
2301 |
Kunde inte återbetala på grund av olaglig eller saknad vara
MSISDN |
| 2302 | Kunde inte återbetala på grund av att meddelande-ID saknas |
| 2303 | I kö för återbetalning |
| 2304 | Tidsgräns för återbetalning |
| 2305 | Återbetalning misslyckades |
| 3000 | GSM-kodning stöds inte |
| 3001 | UCS2-kodning stöds inte |
| 3002 | Binär kodning stöds inte |
| 4000 | Leveransrapport stöds inte |
| 4001 | Ogiltigt meddelandeinnehåll |
| 4002 | Ogiltig taxa |
| 4003 | Ogiltig användardata |
| 4004 | Ogiltig användardatarubrik |
| 4005 | Ogiltig datakodning |
| 4006 | Ogiltig moms |
| 4007 | Innehåll som inte stöds för destinationen |
Dokument/resurser
 |
länk mobilitet SMS API, SMPP API MS Scheduler API [pdf] Användarhandbok SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |