SMS API,SMPP API MS Scheduler API
Brukerveiledning
SMS API,SMPP API MS Scheduler API
| Endret: | 6 |
| Versjon: | 1.7 |
| Forfatter: | Kenny Colander Norden, KCN |
Dette dokumentet er kun for den utpekte mottakeren og kan inneholde privilegert, proprietær eller på annen måte privat informasjon. Hvis du har mottatt den ved en feil, vennligst gi beskjed til avsenderen umiddelbart og slett originalen. All annen bruk av dokumentet av deg er forbudt.
Endre historikk
| Rev | Dato | By | Endringer fra forrige utgivelse |
| 1.0 | 2010-03-16 | KCN | Opprettet |
| 1. | 2019-06-11 | TPE | Oppdaterte LINK-logoer |
| 1. | 2019-09-27 | PNI | Lagt til referanse til SMPP 3.4-spesifikasjonen |
| 1. | 2019-10-31 | EP | Observasjon om gyldighetsperioden tag |
| 1. | 2020-08-28 | KCN | Lagt til informasjon om støttede TLS-versjoner |
| 2. | 2022-01-10 | KCN | Added additional information regarding delivery reports Updated information regarding TLS 1.3 |
| 2. | 2025-06-03 | GM | Added result code 2108 |
| 2. | 2025-06-24 | AK | Added quota |
Introduksjon
LINK Mobility har vært SMS-distributør siden 2001 og har mye erfaring med å jobbe med både operatører og tilkoblingsaggregatorer. Denne plattformen er designet for å håndtere store trafikkmengder, opprettholde høy tilgjengelighet og gjøre det enkelt å rute trafikk via flere forbindelser.
This is document describes the SMPP interface to the SMSC-platform and which parameters and commands that are required and which parameters are supported.
This document will not handle specific use cases as concatenated messages, WAPpush, Flash SMS, etc. More information about those cases can be provided by contacting support.
Støttede kommandoer
LINK Mobilitys server skal behandles som SMPP 3.4. Den offisielle spesifikasjonen finner du på https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Alle metoder støttes ikke, og alle forskjeller er spesifisert nedenfor.
4.1 Bind
Følgende bindekommandoer støttes.
- Sender
- transciever
- Mottaker
Nødvendige parametere:
- system_id – hentet fra support
- passord – hentet fra support
Valgfrie parametere:
- addr_ton – standardverdi hvis TON er satt til Ukjent under innsending.
- addr_npi – standardverdi hvis NPI er satt til Ukjent under innsending.
Ustøttede parametere:
- adresseområde
4.2 Avbind
Unbind-kommandoen støttes.
4.3 Forespørselslenke
Inquire link-kommandoen støttes og bør kalles opp hvert 60. sekund.
4.4 Send inn
Sendemetoden skal brukes for å levere meldinger.
Nødvendige parametere:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- datakoding
- sm_length
- kort melding
Ustøttede parametere:
- tjeneste_type
- protocol_id
- prioritetsflagg
- plan_leveringstid
- replace_if_present_flag
- sm_default_msg_id
Note at nyttelasten tag støttes ikke og kun én SMS kan leveres per samtale, og det anbefales at validity_period tag har en verdi på minst 15 minutter lang.
4.4.1 Anbefalt TON og NPI
Følgende TON og NPI skal brukes når du sender meldinger ved hjelp av submit-kommandoen.
4.4.1.1 Kilde
The following TON and NPI combinations are supported for source address. All other combinations will be treated as invalid. The default TON from bind command will be used if TON is set to Unknown (0). The default NPI from bind command will be used if NPI is set to Unknown (0).
| TONN | NPI | Beskrivelse |
| Alfanumerisk (5) | Ukjent (0) ISDN (1) |
Vil bli behandlet som alfanumerisk avsendertekst |
| Internasjonalt (1) | Ukjent (0) ISDN (1) |
Vil bli behandlet som MSISDN |
| Nasjonalt (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Ukjent (0) ISDN (1) Nasjonalt (8) |
Vil bli behandlet som landsspesifikke kortnummer. |
4.4.1.2 Destinasjon
Følgende TON- og NPI-kombinasjoner støttes for destinasjonsadresse. Alle andre kombinasjoner vil bli behandlet som ugyldige. Standard TON fra bind-kommandoen vil bli brukt hvis TON er satt til Ukjent (0). Standard NPI fra bind-kommandoen vil bli brukt hvis NPI er satt til Ukjent (0).
| TONN | NPI | Beskrivelse |
| Internasjonalt (1) | Ukjent (0) ISDN (1) |
Vil bli behandlet som MSISDN |
4.4.2 Støttede kodinger
Følgende kodinger støttes. X kan inneholde hvilken som helst verdi.
| DCS | Koding |
| 0xX0 | Standard GSM-alfabet med utvidelse |
| 0xX2 | 8-bits binær |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvote
5.1 Quota Overview
A quota defines the maximum number of SMS messages that can be sent within a specified time interval (such as per day, week, month, or indefinitely). Each quota is uniquely identified by a quotaId (UUID) and is reset according to the customer’s time zone. Quotas can be assigned at the country, region, or default level through a Quota Profile. Quota can also be dynamically assigned using Quota Mapping. This maps a parent QuotaId (UUID) and a unique quota Key (e.g., sender or user) to a specific quotaId.
A quota is set in accordance with your local support, your assigned account manager or by default if nothing is specified.
5.2 Status 106 – Quota Exceeded
An SMS message may be blocked with status code 106 (“quota exceeded”) when:
- The message exceeds the defined limit for its corresponding quotaId within the current interval.
- The destination country or region has no quota assigned (i.e., is explicitly blocked with a null quota mapping in the profile).
- There is no matching quota and no default quota is defined, resulting in rejection.
In these cases, the system prevents further message processing to enforce customer or destination-based limits and avoid misuse.
Leveringsrapport
Kun ingen eller endelig levering med vellykket/mislykket resultat støttes.
Format på leveringsrapport: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx fullført dato: ååMMddHHmm stat:
Tilgjengelige verdier i status:
- DELIVRD
- UTLØPT
- AVVISET
- UDELEV
- SLETTET
6.1 Utvidet leveringsrapportformat
Utvidet informasjon i leveringsrapporter kan bli forespurt i kontakt med din salgsrepresentant.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Tilgjengelige verdier i status:
- DELIVRD
- UTLØPT
- AVVISET
- UDELEV
- SLETTET
"sub" og "dlvrd" felt vil alltid være satt til 000, og "text" felt vil alltid være tomt.
Se kapittel Feilkoder for verdier for «feil»-feltet.
Støttede TLS-versjoner
TLS 1.2 eller TLS 1.3 kreves for alle TLS-tilkoblinger over SMPP.
Støtte for TLS 1.0 og 1.1 er avviklet siden 2020-11-15. Versjon 1.0 og 1.1 av TLS er eldre protokoller som har blitt avviklet og anses som sikkerhetsrisikoer i Internett-fellesskapet.
LINK anbefaler på det sterkeste å bruke TLS hvis ukrypterte SMPP-forbindelser brukes i dag. Ukrypterte SMPP-tilkoblinger er avviklet fra og med 2020-09-01 av LINK, og vil bli fjernet i fremtiden. Dato for fjerning av ukrypterte tilkoblinger er ennå ikke bestemt.
Tilkoblinger mot SMPP-serveren for TLS er på port 3601 i stedet for ukryptert på port 3600.
Du kan fortsatt bruke TLS selv om SMPP-implementeringen din ikke støtter TLS ved bruk av stunnel, se https://www.stunnel.org/
Feilkoder
Følgende feilkoder kan bli besvart i feilfeltet hvis feltet er aktivert.
| Feilkode | Beskrivelse |
| 0 | Ukjent feil |
| 1 | Midlertidig rutefeil |
| 2 | Permanent rutingfeil |
| 3 | Maksimal struping overskredet |
| 4 | Tidsavbrudd |
| 5 | Operatør ukjent feil |
| 6 | Operatørfeil |
| 100 | Tjeneste ikke funnet |
| 101 | Bruker ikke funnet |
| 102 | Konto ikke funnet |
| 103 | Ugyldig passord |
| 104 | Konfigurasjonsfeil |
| 105 | Intern feil |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Sendt |
| 1001 | Levert |
| 1002 | Utløpt |
| 1003 | Slettet |
| 1004 | Mobil full |
| 1005 | I kø |
| 1006 | Ikke levert |
| 1007 | Levert, lading forsinket |
| 1008 | Belastet, melding ikke sendt |
| 1009 | Belastet, melding ikke levert |
| 1010 | Utløpt, fravær av operatørleveringsrapport |
| 1011 | Belastet, melding sendt (til operatør) |
| 1012 | Fjernkø |
| 1013 | Melding sendt til operatør, lading forsinket |
| 2000 | Ugyldig kildenummer |
| 2001 | Kort nummer støttes ikke som kilde |
| 2002 | Alfa støttes ikke som kilde |
| 2003 | MSISDN støttes ikke som kildenummer |
| 2100 | Kort nummer støttes ikke som destinasjon |
| 2101 | Alfa støttes ikke som destinasjon |
| 2102 | MSISDN støttes ikke som destinasjon |
| 2103 | Operasjon blokkert |
| 2104 | Ukjent abonnent |
| 2105 | Destinasjon blokkert |
| 2106 | Tallfeil |
| 2107 | Destinasjonen er midlertidig blokkert |
| 2108 | Invalid destination |
| 2200 | Ladefeil |
| 2201 | Abonnenten har lav saldo |
|
2202 |
Subscriber barred for overcharged (premium)
meldinger |
|
2203 |
Subscriber too young (for this particular
innhold) |
| 2204 | Forhåndsbetalt abonnent er ikke tillatt |
| 2205 | Tjenesten avvist av abonnenten |
| 2206 | Abonnent ikke registrert i betalingssystemet |
| 2207 | Abonnenten har nådd maksimal saldo |
| 2208 | Sluttbrukerbekreftelse er nødvendig |
| 2300 | Refundert |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Kunne ikke refundere på grunn av manglende meldings-ID |
| 2303 | I kø for refusjon |
| 2304 | Tidsavbrudd for refusjon |
| 2305 | Tilbakebetalingsfeil |
| 3000 | GSM-koding støttes ikke |
| 3001 | UCS2-koding støttes ikke |
| 3002 | Binær koding støttes ikke |
| 4000 | Leveringsrapport støttes ikke |
| 4001 | Ugyldig meldingsinnhold |
| 4002 | Ugyldig tariff |
| 4003 | Ugyldig brukerdata |
| 4004 | Ugyldig brukerdataoverskrift |
| 4005 | Ugyldig datakoding |
| 4006 | Ugyldig mva |
| 4007 | Innhold som ikke støttes for destinasjonen |
Dokumenter / Ressurser
 |
link mobility SMS API,SMPP API MS Scheduler API [pdfBrukerhåndbok SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |