SMS API, SMPP API MS Scheduler API
Felhasználói kézikönyv
SMS API, SMPP API MS Scheduler API
| Módosított: | 6/24/2025 |
| Változat: | 1.7 |
| Szerző: | Kenny Colander Norden, KCN |
Ez a dokumentum csak a megjelölt címzettnek szól, és tartalmazhat védett, védett vagy egyéb magánjellegű információkat. Ha tévedésből kapta, azonnal értesítse a feladót, és törölje az eredetit. A dokumentum bármilyen más felhasználása tilos.
Változástörténet
| Fordulat | Dátum | By | Változások az előző kiadáshoz képest |
| 1.0 | 2010-03-16 | KCN | Létrehozva |
| 1. | 2019-06-11 | TPE | Frissített LINK logók |
| 1. | 2019-09-27 | PNI | Hivatkozás hozzáadva az SMPP 3.4 specifikációra |
| 1. | 2019-10-31 | EP | Megfigyelés az érvényességi időről tag |
| 1. | 2020-08-28 | KCN | Támogatott TLS-verziókkal kapcsolatos információk hozzáadva |
| 2. | 2022-01-10 | KCN | További információkkal bővült a kézbesítési jelentések Frissített információk a TLS 1.3-mal kapcsolatban |
| 2. | 2025-06-03 | GM | Hozzáadott eredménykód: 2108 |
| 2. | 2025-06-24 | AK | Hozzáadott kvóta |
Bevezetés
A LINK Mobility 2001 óta működik SMS-elosztóként, és sok tapasztalattal rendelkezik mind az üzemeltetők, mind a kapcsolat-összesítők terén. Ezt a platformot úgy tervezték, hogy kezelje a nagy forgalmat, fenntartsa a magas rendelkezésre állást, és megkönnyítse a forgalom több kapcsolaton keresztüli irányítását.
Ez a dokumentum leírja az SMPP SMSC platformhoz való csatlakozását, valamint a szükséges és támogatott paramétereket és parancsokat.
Ez a dokumentum nem foglalkozik olyan konkrét használati esetekkel, mint az összefűzött üzenetek, a WAPpush, a Flash SMS stb. További információért ezekről az esetekről forduljon az ügyfélszolgálathoz.
Támogatott parancsok
LINK A Mobility szerverét SMPP 3.4-ként kell kezelni. A hivatalos specifikáció a címen található https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Az összes módszer nem támogatott, és az összes különbséget az alábbiakban ismertetjük.
4.1 Köt
A következő kötési parancsok támogatottak.
- Adó
- átvevő
- Vevő
Kötelező paraméterek:
- system_id – támogatástól szereztük be
- jelszó – a támogatástól szerezhető be
Opcionális paraméterek:
- addr_ton – alapértelmezett érték, ha a TON értéke Ismeretlen a küldés során.
- addr_npi – alapértelmezett érték, ha az NPI ismeretlenre van állítva a küldés során.
Nem támogatott paraméterek:
- címtartomány
4.2 Kötés feloldása
Az unbind parancs támogatott.
4.3 Érdeklődni link
Az inquire link parancs támogatott, és 60 másodpercenként kell meghívni.
4.4 Beküldés
Az üzenetek kézbesítéséhez a beküldési módot kell használni.
Kötelező paraméterek:
- source_addr_ton
- source_addr_npi
- forrás_cím
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- rövid üzenet
Nem támogatott paraméterek:
- A szolgáltatás típusa
- protokoll_id
- priority_flag
- ütemterv_szállítási_idő
- helyettesít_ha_jelen_jelző
- sm_default_msg_id
Jegyzet hogy a hasznos teher tag nem támogatott, és hívásonként csak egy SMS kézbesíthető, és ajánlott az érvényességi_időszak tag értéke legalább 15 perc hosszú.
4.4.1 Ajánlott TON és NPI
A következő TON-t és NPI-t kell használni, ha üzeneteket küld a submit paranccsal.
4.4.1.1 Forrás
A következő TON és NPI kombinációk támogatottak forráscímként. Minden más kombináció érvénytelennek lesz tekintve. A bind parancs alapértelmezett TON-ja lesz használatos, ha a TON értéke Ismeretlen (0). A bind parancs alapértelmezett NPI-je lesz használatos, ha az NPI értéke Ismeretlen (0).
| TONNA | NPI | Leírás |
| Alfanumerikus (5) | Ismeretlen (0) ISDN (1) |
Alfanumerikus küldőszövegként lesz kezelve |
| Nemzetközi (1) | Ismeretlen (0) ISDN (1) |
MSISDN-ként lesz kezelve |
| Nemzeti (2) Hálózatspecifikus (3) Előfizetői szám (4) Rövidített (6) |
Ismeretlen (0) ISDN (1) Nemzeti (8) |
A rendszer országspecifikus rövid számként kezeli. |
4.4.1.2 Cél
A következő TON és NPI kombinációk támogatottak célcímként. Minden más kombináció érvénytelennek minősül. A rendszer az alapértelmezett TON from bind parancsot használja, ha a TON értéke Ismeretlen (0). A rendszer az alapértelmezett NPI from bind parancsot használja, ha az NPI Ismeretlen (0) értékre van állítva.
| TONNA | NPI | Leírás |
| Nemzetközi (1) | Ismeretlen (0) ISDN (1) |
MSISDN-ként lesz kezelve |
4.4.2 Támogatott kódolások
A következő kódolások támogatottak. X bármilyen értéket tartalmazhat.
| DCS | Kódolás |
| 0xX0 | Alapértelmezett GSM ábécé kiterjesztéssel |
| 0xX2 | 8 bites bináris |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvóta
5.1 Kvóta túllépéseview
A kvóta meghatározza az egy adott időintervallumon belül (például naponta, hetente, havonta vagy határozatlan ideig) elküldhető SMS-üzenetek maximális számát. Minden kvótát egyedileg azonosít egy kvótaazonosító (UUID), és az ügyfél időzónája szerint visszaáll. A kvóták országonként, régiónként vagy alapértelmezett szinten hozzárendelhetők egy Quota Pro segítségével.fileA kvóta dinamikusan is hozzárendelhető a kvóta-leképezés segítségével. Ez egy szülő kvótaazonosítót (UUID) és egy egyedi kvótakulcsot (pl. küldő vagy felhasználó) egy adott kvótaazonosítóhoz rendel.
A kvótát a helyi támogatási szolgálat, a hozzárendelt fiókkezelő vagy – ha nincs más megadva – alapértelmezés szerint állítjuk be.
5.2 106. állapot – Kvóta túllépése
Egy SMS üzenet blokkolható a 106-os állapotkóddal („kvóta túllépve”), ha:
- Az üzenet meghaladja a megfelelő kvótaazonosítóhoz definiált korlátot az aktuális intervallumon belül.
- A célországhoz vagy -régióhoz nincs hozzárendelve kvóta (azaz explicit módon blokkolva van null kvóta-hozzárendeléssel a pro-ban).file).
- Nincs megfelelő kvóta, és nincs definiálva alapértelmezett kvóta, ami elutasításhoz vezet.
Ezekben az esetekben a rendszer megakadályozza a további üzenetfeldolgozást az ügyfél- vagy célállomás-alapú korlátozások betartatása és a visszaélések elkerülése érdekében.
Kézbesítési jelentés
Csak a nincs vagy a sikeres/sikertelen eredménnyel rendelkező végleges kézbesítés támogatott.
Formátum a kézbesítési jelentésben: ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Kész Dátum: YYMMDDHHMM STAT:
Állapotban elérhető értékek:
- DELIVRD
- LEJÁRT
- ELUTASÍTVA
- UNDELIV
- TÖRÖLVE
6.1 Kiterjesztett kézbesítési jelentés formátum
A szállítási jelentésekben található bővített információk kérhetők értékesítési képviselőjétől.
Szállítási jelentés formátuma: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 beküldés dátuma:
ééHHNNÓÓpp készült dátuma: ééHHNNÓÓpp stat: téved: szöveg:
Állapotban elérhető értékek:
- DELIVRD
- LEJÁRT
- ELUTASÍTVA
- UNDELIV
- TÖRÖLVE
A „sub” és „dlvrd” mezők értéke mindig 000, a „text” mező pedig mindig üres.
Az „err” mező értékeit lásd a Hibakódok fejezetben.
Támogatott TLS-verziók
TLS 1.2 vagy TLS 1.3 szükséges minden SMPP-n keresztüli TLS-kapcsolathoz.
A TLS 1.0 és 1.1 támogatása 2020-11-15 óta megszűnik. A TLS 1.0-s és 1.1-es verziója régebbi protokollok, amelyek elavultak, és biztonsági kockázatnak számítanak az internetes közösségben.
LINK erősen ajánlja a TLS használatát, ha ma titkosítatlan SMPP kapcsolatokat használnak. A titkosítatlan SMPP-kapcsolatokat a LINK 2020-09-01-től elavulttá vált, és a jövőben eltávolítjuk. A titkosítatlan kapcsolatok eltávolításának dátuma még nincs eldöntve.
A TLS SMPP-kiszolgálója felé tartó kapcsolatok a 3601-es porton vannak, a 3600-as porton pedig titkosítatlanok.
Továbbra is használhatja a TLS-t, még akkor is, ha az SMPP-megvalósítás nem támogatja a TLS-t a stunnel használatával, lásd https://www.stunnel.org/
Hibakódok
A következő hibakódok jelenhetnek meg a hiba mezőben, ha a mező engedélyezve van.
| Hibakód | Leírás |
| 0 | Ismeretlen hiba |
| 1 | Ideiglenes útválasztási hiba |
| 2 | Állandó útválasztási hiba |
| 3 | Túllépte a maximális fojtást |
| 4 | Időtúllépés |
| 5 | Ismeretlen kezelői hiba |
| 6 | Kezelői hiba |
| 100 | Szolgáltatás nem található |
| 101 | Felhasználó nem található |
| 102 | Fiók nem található |
| 103 | Érvénytelen jelszó |
| 104 | Konfigurációs hiba |
| 105 | Belső hiba |
| 106 | Kvóta túllépése |
| 200 | OK |
| 1000 | Küldött |
| 1001 | Szállítva |
| 1002 | Lejárt |
| 1003 | Törölve |
| 1004 | Tele a mobil |
| 1005 | Sorban |
| 1006 | Nincs kézbesítve |
| 1007 | Kiszállítva, a töltés késik |
| 1008 | Fel van töltve, üzenetet nem küldtek el |
| 1009 | Fel van töltve, az üzenetet nem kézbesítették |
| 1010 | Lejárt, kezelői kézbesítési jelentés hiánya |
| 1011 | Felszámítva, üzenet elküldve (a kezelőnek) |
| 1012 | Távoli sorban állás |
| 1013 | Üzenet elküldve a kezelőnek, a töltés késik |
| 2000 | Érvénytelen forrásszám |
| 2001 | A rövid szám nem támogatott forrásként |
| 2002 | Az Alpha nem támogatott forrásként |
| 2003 | Az MSISDN nem támogatott forrásszámként |
| 2100 | A rövid szám nem támogatott célként |
| 2101 | Az alfa nem támogatott célként |
| 2102 | Az MSISDN nem támogatott célként |
| 2103 | A művelet blokkolva |
| 2104 | Ismeretlen előfizető |
| 2105 | Az úti cél blokkolva |
| 2106 | Szám hiba |
| 2107 | Az úti cél átmenetileg blokkolva |
| 2108 | Érvénytelen célállomás |
| 2200 | Töltési hiba |
| 2201 | Az előfizető egyenlege alacsony |
|
2202 |
Előfizetőt tiltottak le túlszámlázás miatt (prémium)
üzeneteket |
|
2203 |
Túl fiatal az előfizető (erre a konkrét esetre)
tartalom) |
| 2204 | Előre fizetett előfizető nem engedélyezett |
| 2205 | A szolgáltatást az előfizető elutasította |
| 2206 | Az előfizető nem regisztrált a fizetési rendszerben |
| 2207 | Az előfizető elérte a maximális egyenleget |
| 2208 | Végfelhasználói megerősítés szükséges |
| 2300 | Visszatérítve |
|
2301 |
Nem sikerült visszatérítést biztosítani illegális vagy hiányzó fizetés miatt.
MSISDN |
| 2302 | Nem sikerült visszatéríteni a hiányzó üzenetazonosító miatt |
| 2303 | Várakozás a visszatérítésért |
| 2304 | Visszatérítési időtúllépés |
| 2305 | Visszatérítési hiba |
| 3000 | A GSM kódolás nem támogatott |
| 3001 | Az UCS2 kódolás nem támogatott |
| 3002 | A bináris kódolás nem támogatott |
| 4000 | A kézbesítési jelentés nem támogatott |
| 4001 | Érvénytelen üzenettartalom |
| 4002 | Érvénytelen tarifa |
| 4003 | Érvénytelen felhasználói adatok |
| 4004 | Érvénytelen felhasználói adatfejléc |
| 4005 | Érvénytelen adatkódolás |
| 4006 | Érvénytelen áfa |
| 4007 | Nem támogatott tartalom a célhoz |
Dokumentumok / Források
 |
link mobilitás SMS API, SMPP API MS Scheduler API [pdf] Felhasználói útmutató SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |