SMS API,SMPP API MS Scheduler API
Ghidul utilizatorului
SMS API,SMPP API MS Scheduler API
| Modificat: | 6/24/2025 |
| Versiune: | 1.7 |
| Autor: | Kenny Colander Norden, KCN |
Acest document este destinat exclusiv destinatarului desemnat și poate conține informații privilegiate, proprietare sau private. Dacă ați primit-o din greșeală, vă rugăm să anunțați imediat expeditorul și să ștergeți originalul. Orice altă utilizare a documentului de către dumneavoastră este interzisă.
Schimbă istoricul
| Rev | Data | By | Modificări față de versiunea anterioară |
| 1.0 | 2010-03-16 | KCN | Creat |
| 1. | 2019-06-11 | TPE | Siglele LINK actualizate |
| 1. | 2019-09-27 | PNI | S-a adăugat referință la specificația SMPP 3.4 |
| 1. | 2019-10-31 | EP | Observatie despre perioada de valabilitate tag |
| 1. | 2020-08-28 | KCN | S-au adăugat informații privind versiunile TLS acceptate |
| 2. | 2022-01-10 | KCN | Adăugate informații suplimentare privind rapoartele de livrare Informații actualizate privind TLS 1.3 |
| 2. | 2025-06-03 | GM | Codul rezultatului adăugat 2108 |
| 2. | 2025-06-24 | AK | Cotă adăugată |
Introducere
LINK Mobility este distribuitor de SMS-uri din 2001 și are multă experiență în lucrul atât cu operatorii, cât și cu agregatorii de conexiuni. Această platformă este concepută pentru a gestiona volume mari de trafic, menține o disponibilitate ridicată și facilitează direcționarea traficului prin conexiuni multiple.
Acest document descrie interfața SMPP cu platforma SMSC, parametrii și comenzile necesare și parametrii acceptați.
Acest document nu va trata cazuri de utilizare specifice, cum ar fi mesajele concatenate, WAPpush, Flash SMS etc. Mai multe informații despre aceste cazuri pot fi furnizate contactând serviciul de asistență.
Comenzi acceptate
Serverul LINK Mobility ar trebui tratat ca SMPP 3.4. Specificația oficială poate fi găsită la https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Nu toate metodele sunt acceptate, iar toate diferențele sunt specificate mai jos.
4.1 Legați
Sunt acceptate următoarele comenzi de legătură.
- Transmiţător
- transciver
- Receptor
Parametri necesari:
- system_id – obținut din suport
- parola – obținută de la asistență
Parametri optionali:
- addr_ton – valoare implicită dacă TON este setat la Necunoscut în timpul trimiterii.
- addr_npi – valoare implicită dacă NPI este setat la Necunoscut în timpul trimiterii.
Parametri neacceptați:
- interval_adresă
4.2 Dezlegare
Comanda unbind este acceptată.
4.3 Întrebare link
Comanda inquire link este acceptată și trebuie apelată la fiecare 60 de secunde.
4.4 Trimiteți
Metoda de trimitere ar trebui utilizată pentru livrarea mesajelor.
Parametri necesari:
- adresă_sursă
- source_addr_npi
- adresa_sursă
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- codificare_date
- sm_length
- mesaj scurt
Parametri neacceptați:
- tip_serviciu
- protocol_id
- steag_priority
- program_delivery_time
- înlocuiți_dacă_steagul_prezent
- sm_default_msg_id
Nota că sarcina utilă tag nu este acceptat și poate fi livrat un singur SMS per apel și se recomandă ca perioada de valabilitate tag are o valoare de cel puțin 15 minute.
4.4.1 TON și NPI recomandate
Următoarele TON și NPI ar trebui utilizate atunci când trimiteți mesaje folosind comanda de trimitere.
4.4.1.1 Sursa
Următoarele combinații TON și NPI sunt acceptate pentru adresa sursă. Toate celelalte combinații vor fi tratate ca nevalide. TON implicit din comanda bind va fi utilizat dacă TON este setat la Necunoscut (0). NPI implicit din comanda bind va fi utilizat dacă NPI este setat la Necunoscut (0).
| TONĂ | NPI | Descriere |
| Alfanumerice (5) | Necunoscut (0) ISDN (1) |
Va fi tratat ca text alfanumeric al expeditorului |
| Internațional (1) | Necunoscut (0) ISDN (1) |
Va fi tratat ca MSISDN |
| National (2) Specific rețelei (3) Număr de abonat (4) Prescurtat (6) |
Necunoscut (0) ISDN (1) National (8) |
Va fi tratat ca un număr scurt specific țării. |
4.4.1.2 Destinație
Următoarele combinații TON și NPI sunt acceptate pentru adresa de destinație. Toate celelalte combinații vor fi tratate ca nevalide. Comanda implicită TON din bind va fi utilizată dacă TON este setat la Necunoscut (0). NPI implicit de la comanda bind va fi folosit dacă NPI este setat la Necunoscut (0).
| TONĂ | NPI | Descriere |
| Internațional (1) | Necunoscut (0) ISDN (1) |
Va fi tratat ca MSISDN |
4.4.2 Codificări acceptate
Sunt acceptate următoarele codificări. X poate conține orice valoare.
| DCS | Codificare |
| 0xX0 | Alfabet GSM implicit cu extensie |
| 0xX2 | binar pe 8 biți |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Cotă
5.1 Cotă depășităview
O cotă definește numărul maxim de mesaje SMS care pot fi trimise într-un interval de timp specificat (cum ar fi pe zi, săptămână, lună sau pe termen nelimitat). Fiecare cotă este identificată în mod unic printr-un ID de cotă (UUID) și este resetată în funcție de fusul orar al clientului. Cotele pot fi atribuite la nivel de țară, regiune sau implicit prin intermediul unui program Quota Pro.fileCotele pot fi atribuite și dinamic folosind maparea cotelor. Aceasta mapează un ID de cotă părinte (UUID) și o cheie de cotă unică (de exemplu, expeditor sau utilizator) la un anumit ID de cotă.
O cotă este stabilită în conformitate cu asistența locală, managerul de cont desemnat sau, în mod implicit, dacă nu este specificat nimic.
5.2 Status 106 – Cotă depășită
Un mesaj SMS poate fi blocat cu codul de stare 106 („cotă depășită”) atunci când:
- Mesajul depășește limita definită pentru ID-ul quota corespunzător în intervalul curent.
- Țara sau regiunea de destinație nu are nicio cotă atribuită (adică este blocată explicit cu o mapare de cotă nulă în programul de programare).file).
- Nu există o cotă corespunzătoare și nu este definită nicio cotă implicită, ceea ce duce la respingere.
În aceste cazuri, sistemul previne procesarea ulterioară a mesajelor pentru a impune limite bazate pe client sau destinație și pentru a evita utilizarea necorespunzătoare.
Raport de livrare
Nu sunt acceptate decât nicio livrare sau livrarea finală cu rezultat de succes/eșec.
Formatul raportului de livrare: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx data realizarii: aaMMddHHmm stat:
Valori disponibile în stare:
- DELIVRD
- EXPIRAT
- RESPINSD
- UNDELIV
- ȘTERS
6.1 Format de raport de livrare extins
Informații extinse din rapoartele de livrare pot fi solicitate contactând reprezentantul dumneavoastră de vânzări.
Format raport de livrare: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 dată trimitere:
aaLLzzHHmm data încheierii: aaLLzzHHmm stat: greșeală: text:
Valori disponibile în stare:
- DELIVRD
- EXPIRAT
- RESPINSD
- UNDELIV
- ȘTERS
Câmpurile „sub” și „dlvrd” vor fi întotdeauna setate la 000, iar câmpul „text” va fi întotdeauna gol.
Consultați capitolul Coduri de eroare pentru valorile câmpului „err”.
Versiuni TLS acceptate
TLS 1.2 sau TLS 1.3 este necesar pentru toate conexiunile TLS prin SMPP.
Suportul pentru TLS 1.0 și 1.1 este întrerupt din 2020-11-15. Versiunile 1.0 și 1.1 ale TLS sunt protocoale mai vechi care au fost depreciate și sunt considerate riscuri de securitate în comunitatea Internet.
LINK recomandă insistent să utilizați TLS dacă astăzi sunt utilizate conexiuni SMPP necriptate. Conexiunile SMPP necriptate sunt depreciate din 2020-09-01 de către LINK și vor fi eliminate în viitor. Data pentru eliminarea conexiunilor necriptate nu a fost încă decisă.
Conexiunile către serverul SMPP pentru TLS sunt la portul 3601 în loc să fie necriptate la portul 3600.
Puteți utiliza în continuare TLS chiar dacă implementarea dvs. SMPP nu acceptă TLS folosind stunnel, vezi https://www.stunnel.org/
Coduri de eroare
Următoarele coduri de eroare pot primi răspuns în câmpul err dacă câmpul este activat.
| Cod de eroare | Descriere |
| 0 | Eroare necunoscută |
| 1 | Eroare temporară de rutare |
| 2 | Eroare permanentă de rutare |
| 3 | Limitarea maximă a fost depășită |
| 4 | Pauză |
| 5 | Eroare necunoscută de operator |
| 6 | Eroare de operator |
| 100 | Serviciu negăsit |
| 101 | Utilizatorul nu a fost găsit |
| 102 | Contul nu a fost găsit |
| 103 | Parolă Invalidă |
| 104 | Eroare de configurare |
| 105 | Eroare internă |
| 106 | Cotă depășită |
| 200 | OK |
| 1000 | Trimis |
| 1001 | Livrat |
| 1002 | Expirat |
| 1003 | Șters |
| 1004 | Mobil plin |
| 1005 | În coadă |
| 1006 | Nu este livrat |
| 1007 | Livrat, încărcare întârziată |
| 1008 | Încărcat, mesajul nu a fost trimis |
| 1009 | Încărcat, mesajul nu a fost livrat |
| 1010 | Expirat, absența raportului de livrare operator |
| 1011 | Încărcat, mesaj trimis (către operator) |
| 1012 | La distanță la coadă |
| 1013 | Mesaj trimis operatorului, încărcare întârziată |
| 2000 | Număr sursă nevalid |
| 2001 | Numărul scurt nu este acceptat ca sursă |
| 2002 | Alpha nu este acceptat ca sursă |
| 2003 | MSISDN nu este acceptat ca număr sursă |
| 2100 | Numărul scurt nu este acceptat ca destinație |
| 2101 | Alpha nu este acceptat ca destinație |
| 2102 | MSISDN nu este acceptat ca destinație |
| 2103 | Operațiune blocată |
| 2104 | Abonat necunoscut |
| 2105 | Destinație blocată |
| 2106 | Eroare de număr |
| 2107 | Destinație blocată temporar |
| 2108 | Destinație nevalidă |
| 2200 | Eroare de încărcare |
| 2201 | Abonatul are soldul scăzut |
|
2202 |
Abonat blocat pentru suprataxat (premium)
mesaje |
|
2203 |
Abonat prea tânăr (pentru acest aspect particular)
conţinut) |
| 2204 | Abonatul preplătit nu este permis |
| 2205 | Serviciu respins de abonat |
| 2206 | Abonatul nu este înregistrat în sistemul de plată |
| 2207 | Abonatul a atins soldul maxim |
| 2208 | Este necesară confirmarea utilizatorului final |
| 2300 | Rambursat |
|
2301 |
Nu s-a putut rambursa din cauza unor erori sau a unor erori lipsă.
MSISDN |
| 2302 | Nu s-a putut rambursa din cauza lipsei mesajului ID |
| 2303 | Ați stat la coadă pentru rambursare |
| 2304 | Timeout pentru rambursare |
| 2305 | Eșecul rambursării |
| 3000 | Codificarea GSM nu este acceptată |
| 3001 | Codificarea UCS2 nu este acceptată |
| 3002 | Codificarea binară nu este acceptată |
| 4000 | Raportul de livrare nu este acceptat |
| 4001 | Conținutul mesajului nevalid |
| 4002 | Tarif nevalid |
| 4003 | Date utilizator nevalide |
| 4004 | Antet de date utilizator nevalid |
| 4005 | Codarea datelor nevalidă |
| 4006 | TVA nevalid |
| 4007 | Conținut neacceptat pentru destinație |
Documente/Resurse
 |
link mobility SMS API,SMPP API MS Scheduler API [pdfGhid de utilizare SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |