SMS API, SMPP API MS Scheduler API
Uživatelská příručka
SMS API, SMPP API MS Scheduler API
| Upraveno: | 6. 24. 2025 |
| Verze: | 1.7 |
| Autor: | Kenny Colander Norden, KCN |
Tento dokument je pouze pro určeného příjemce a může obsahovat privilegované, vlastnické nebo jinak soukromé informace. Pokud jste jej obdrželi omylem, neprodleně informujte odesílatele a originál smažte. Jakékoli jiné použití dokumentu z vaší strany je zakázáno.
Historie změn
| Rev | Datum | By | Změny oproti předchozí verzi |
| 1.0 | 2010-03-16 | KCN | Vytvořeno |
| 1. | 2019-06-11 | TPE | Aktualizovaná loga LINK |
| 1. | 2019-09-27 | PNI | Přidán odkaz na specifikaci SMPP 3.4 |
| 1. | 2019-10-31 | EP | Pozorování o době platnosti tag |
| 1. | 2020-08-28 | KCN | Přidány informace o podporovaných verzích TLS |
| 2. | 2022-01-10 | KCN | Přidány další informace týkající se zpráv o doručení Aktualizované informace týkající se TLS 1.3 |
| 2. | 2025-06-03 | GM | Přidán výsledný kód 2108 |
| 2. | 2025-06-24 | AK | Přidaná kvóta |
Zavedení
LINK Mobility je distributorem SMS od roku 2001 a má bohaté zkušenosti s prací jak s operátory, tak s agregátory připojení. Tato platforma je navržena tak, aby zvládala velké objemy provozu, udržovala vysokou dostupnost a usnadňovala směrování provozu prostřednictvím více připojení.
Tento dokument popisuje rozhraní SMPP k platformě SMSC a které parametry a příkazy jsou vyžadovány a které parametry jsou podporovány.
Tento dokument se nebude zabývat konkrétními případy použití, jako jsou zřetězené zprávy, WAPpush, Flash SMS atd. Více informací o těchto případech vám poskytne podpora.
Podporované příkazy
Server LINK Mobility by měl být považován za SMPP 3.4. Oficiální specifikace najdete na https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Všechny metody nejsou podporovány a všechny rozdíly jsou uvedeny níže.
4.1 Svázat
Jsou podporovány následující příkazy vazby.
- Vysílač
- transciever
- Přijímač
Požadované parametry:
- system_id – získané z podpory
- heslo – získané z podpory
Volitelné parametry:
- addr_ton – výchozí hodnota, pokud je TON při odesílání nastaven na Neznámý.
- addr_npi – výchozí hodnota, pokud je NPI při odesílání nastaveno na Neznámý.
Nepodporované parametry:
- rozsah_adres
4.2 Zrušit vazbu
Příkaz unbind je podporován.
4.3 Odkaz na dotaz
Příkaz inquire link je podporován a měl by být volán každých 60 sekund.
4.4 Odeslat
Pro doručování zpráv by měla být použita metoda odesílání.
Požadované parametry:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- kódování dat
- sm_length
- krátká zpráva
Nepodporované parametry:
- Typ služby
- protocol_id
- prioritní_příznak
- naplánovat_čas_doručení
- nahradit_pokud_příznak_příznaku
- sm_default_msg_id
Poznámka že užitečné zatížení tag není podporována a na jeden hovor může být doručena pouze jedna SMS a doporučuje se, aby doba platnosti tag má hodnotu minimálně 15 minut.
4.4.1 Doporučené TON a NPI
Následující TON a NPI by měly být použity při odesílání zpráv pomocí příkazu pro odeslání.
4.4.1.1 Zdroj
Pro zdrojovou adresu jsou podporovány následující kombinace TON a NPI. Všechny ostatní kombinace budou považovány za neplatné. Pokud je TON nastaven na Neznámý (0), bude použit výchozí příkaz TON z vazby. Pokud je NPI nastaven na Neznámý (0), bude použit výchozí příkaz NPI z vazby.
| TÓN | NPI | Popis |
| Alfanumerické (5) | Neznámý (0) ISDN (1) |
Bude považováno za alfanumerický text odesílatele |
| mezinárodní (1) | Neznámý (0) ISDN (1) |
Bude považováno za MSISDN |
| Národní (2) Specifické pro síť (3) Číslo předplatitele (4) Zkrácené (6) |
Neznámý (0) ISDN (1) Národní (8) |
Bude považováno za krátké číslo specifické pro danou zemi. |
4.4.1.2 Místo určení
Pro cílovou adresu jsou podporovány následující kombinace TON a NPI. Všechny ostatní kombinace budou považovány za neplatné. Pokud je TON nastaven na Neznámý (0), použije se výchozí příkaz TON z vazby. Pokud je NPI nastaveno na Neznámý (0), použije se výchozí NPI z příkazu bind.
| TÓN | NPI | Popis |
| mezinárodní (1) | Neznámý (0) ISDN (1) |
Bude považováno za MSISDN |
4.4.2 Podporovaná kódování
Jsou podporována následující kódování. X může obsahovat libovolnou hodnotu.
| DCS | Kódování |
| 0xX0 | Výchozí GSM abeceda s příponou |
| 0xX2 | 8bitové binární |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvóta
5.1 Překročení kvótyview
Kvóta definuje maximální počet SMS zpráv, které lze odeslat v daném časovém intervalu (například za den, týden, měsíc nebo na dobu neurčitou). Každá kvóta je jedinečně identifikována identifikátorem quotaId (UUID) a je resetována podle časového pásma zákazníka. Kvóty lze přiřadit na úrovni země, regionu nebo výchozí úrovně prostřednictvím nástroje Quota Pro.fileKvótu lze také dynamicky přiřazovat pomocí mapování kvót. Toto mapování namapuje nadřazené ID kvóty (UUID) a jedinečný klíč kvóty (např. odesílatele nebo uživatele) na konkrétní ID kvóty.
Kvóta je nastavena v souladu s vaší místní podporou, vaším přiděleným správcem účtu nebo standardně, pokud není nic uvedeno.
5.2 Stav 106 – Kvóta překročena
SMS zpráva může být zablokována se stavovým kódem 106 („kvóta překročena“), pokud:
- Zpráva překračuje definovaný limit pro odpovídající ID kvóty v rámci aktuálního intervalu.
- Cílová země nebo oblast nemá přiřazenou žádnou kvótu (tj. je explicitně blokována s mapováním nulové kvóty v programufile).
- Neexistuje žádná odpovídající kvóta a není definována žádná výchozí kvóta, což má za následek odmítnutí.
V těchto případech systém zabrání dalšímu zpracování zpráv, aby vynutil limity dané zákazníkem nebo cílem a zabránil zneužití.
Dodávkový list
Podporováno je pouze žádné nebo konečné doručení s úspěšným/neúspěšným výsledkem.
Formát zprávy o doručení: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx datum provedení: yyMMddHHmm stat:
Dostupné hodnoty ve stavu:
- DELIVRD
- VYPRŠEL
- ODMÍTNUTO
- UNDELIV
- SMAŽENO
6.1 Rozšířený formát zprávy o doručení
Rozšířené informace ve zprávách o doručení si můžete vyžádat u svého obchodního zástupce.
Formát doručovací zprávy: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 datum odeslání:
rrMMddHHmm datum dokončení: rrMMddHHmm stat: chybovat: text:
Dostupné hodnoty ve stavu:
- DELIVRD
- VYPRŠEL
- ODMÍTNUTO
- UNDELIV
- SMAŽENO
Pole „sub“ a „dlvrd“ budou vždy nastavena na 000 a pole „text“ bude vždy prázdné.
Hodnoty pro pole „err“ naleznete v kapitole Kódy chyb.
Podporované verze TLS
Pro všechna připojení TLS přes SMPP je vyžadován TLS 1.2 nebo TLS 1.3.
Podpora pro TLS 1.0 a 1.1 je ukončena od 2020. 11. 15. Verze 1.0 a 1.1 TLS jsou starší protokoly, které byly zastaralé a jsou v internetové komunitě považovány za bezpečnostní rizika.
LINK důrazně doporučuje používat TLS, pokud se dnes používají nešifrovaná připojení SMPP. Nešifrovaná připojení SMPP jsou od 2020-09-01 ukončena LINK a budou v budoucnu odstraněna. Datum odstranění nešifrovaných připojení ještě není rozhodnuto.
Připojení k serveru SMPP pro TLS je na portu 3601 místo nešifrovaného na portu 3600.
TLS můžete stále používat, i když vaše implementace SMPP nepodporuje TLS pomocí stunnelu, viz https://www.stunnel.org/
Chybové kódy
Pokud je pole povoleno, mohou být v poli Err zodpovězeny následující chybové kódy.
| Kód chyby | Popis |
| 0 | Neznámá chyba |
| 1 | Dočasná chyba směrování |
| 2 | Trvalá chyba směrování |
| 3 | Překročeno maximální škrcení |
| 4 | Časový limit |
| 5 | Neznámá chyba operátora |
| 6 | Chyba operátora |
| 100 | Služba nenalezena |
| 101 | Uživatel nenalezen |
| 102 | účet nenalezen |
| 103 | Neplatné heslo |
| 104 | Chyba konfigurace |
| 105 | Vnitřní chyba |
| 106 | Kvóta překročena |
| 200 | OK |
| 1000 | Odesláno |
| 1001 | Doručeno |
| 1002 | Platnost vypršela |
| 1003 | Smazáno |
| 1004 | Mobil plný |
| 1005 | Ve frontě |
| 1006 | Nedoručeno |
| 1007 | Doručeno, nabití zpožděno |
| 1008 | Nabito, zpráva nebyla odeslána |
| 1009 | Nabito, zpráva nedoručena |
| 1010 | Platnost vypršela, chybí zpráva o doručení operátora |
| 1011 | Nabito, zpráva odeslána (operátorovi) |
| 1012 | Vzdáleně ve frontě |
| 1013 | Zpráva byla odeslána operátorovi, nabíjení zpožděno |
| 2000 | Neplatné číslo zdroje |
| 2001 | Krátké číslo není jako zdroj podporováno |
| 2002 | Alfa není podporována jako zdroj |
| 2003 | MSISDN není podporováno jako zdrojové číslo |
| 2100 | Krátké číslo není podporováno jako cíl |
| 2101 | Alfa není podporována jako cíl |
| 2102 | MSISDN není podporováno jako cíl |
| 2103 | Operace zablokována |
| 2104 | Neznámý předplatitel |
| 2105 | Cíl zablokován |
| 2106 | Chyba čísla |
| 2107 | Cíl dočasně zablokován |
| 2108 | Neplatný cíl |
| 2200 | Chyba nabíjení |
| 2201 | Předplatitel má nízký zůstatek |
|
2202 |
Předplatitel byl zablokován kvůli nadměrnému naúčtování (prémiové)
zprávy |
|
2203 |
Předplatitel je příliš mladý (pro tento konkrétní
obsah) |
| 2204 | Předplatitel není povolen |
| 2205 | Služba odmítnuta předplatitelem |
| 2206 | Účastník není registrován v platebním systému |
| 2207 | Předplatitel dosáhl maximálního zůstatku |
| 2208 | Je vyžadováno potvrzení koncovým uživatelem |
| 2300 | Vráceno |
|
2301 |
Nelze vrátit peníze z důvodu nelegálního nebo chybějícího zboží
MSISDN |
| 2302 | Nelze vrátit peníze z důvodu chybějícího ID zprávy |
| 2303 | Čeká na vrácení peněz |
| 2304 | Časový limit pro vrácení peněz |
| 2305 | Selhání vrácení peněz |
| 3000 | GSM kódování není podporováno |
| 3001 | Kódování UCS2 není podporováno |
| 3002 | Binární kódování není podporováno |
| 4000 | Zpráva o doručení není podporována |
| 4001 | Neplatný obsah zprávy |
| 4002 | Neplatný tarif |
| 4003 | Neplatná uživatelská data |
| 4004 | Neplatné záhlaví uživatelských dat |
| 4005 | Neplatné kódování dat |
| 4006 | Neplatná DPH |
| 4007 | Nepodporovaný obsah pro cíl |
Dokumenty / zdroje
 |
mobilita odkazů SMS API, SMPP API MS Scheduler API [pdfUživatelská příručka SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |