SMS API, SMPP API MS plānotāja API
Lietotāja rokasgrāmata
SMS API, SMPP API MS plānotāja API
| Modificēts: | 6/24/2025 |
| Versija: | 1.7 |
| Autors: | Kenijs Kolanders Nordens, KCN |
Šis dokuments ir paredzēts tikai norādītajam adresātam, un tas var saturēt priviliģētu, patentētu vai citādi privātu informāciju. Ja esat to saņēmis kļūdas dēļ, lūdzu, nekavējoties informējiet sūtītāju un izdzēsiet oriģinālu. Jebkāda cita dokumenta izmantošana jums ir aizliegta.
Izmaiņu vēsture
| Rev | Datums | By | Izmaiņas salīdzinājumā ar iepriekšējo laidienu |
| 1.0 | 2010-03-16 | KCN | Izveidots |
| 1. | 2019-06-11 | TPE | Atjaunināti LINK logotipi |
| 1. | 2019-09-27 | PNI | Pievienota atsauce uz SMPP 3.4 specifikāciju |
| 1. | 2019-10-31 | EP | Novērojums par derīguma termiņu tag |
| 1. | 2020-08-28 | KCN | Pievienota informācija par atbalstītajām TLS versijām |
| 2. | 2022-01-10 | KCN | Pievienota papildu informācija par piegādes ziņojumiem Atjaunināta informācija par TLS 1.3 |
| 2. | 2025-06-03 | GM | Pievienots rezultāta kods 2108 |
| 2. | 2025-06-24 | AK | Pievienota kvota |
Ievads
LINK Mobility ir SMS izplatītājs kopš 2001. gada, un tam ir liela pieredze darbā gan ar operatoriem, gan savienojumu apkopotājiem. Šī platforma ir izstrādāta, lai apkalpotu lielus satiksmes apjomus, uzturētu augstu pieejamību un atvieglotu satiksmes maršrutēšanu, izmantojot vairākus savienojumus.
Šajā dokumentā ir aprakstīta SMPP saskarne ar SMSC platformu, kā arī nepieciešamie parametri un komandas, un atbalstītie parametri.
Šajā dokumentā netiks aplūkoti specifiski lietošanas gadījumi, piemēram, apvienotie ziņojumi, WAPpush, Flash SMS utt. Plašāku informāciju par šiem gadījumiem var sniegt, sazinoties ar atbalsta dienestu.
Atbalstītās komandas
LINK Mobilitātes serveris jāuzskata par SMPP 3.4. Oficiālo specifikāciju var atrast vietnē https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Visas metodes netiek atbalstītas, un visas atšķirības ir norādītas tālāk.
4.1 Saistīt
Tiek atbalstītas šādas saistīšanas komandas.
- Raidītājs
- Transcivers
- Uztvērējs
Nepieciešamie parametri:
- system_id – iegūts no atbalsta
- parole – iegūta no atbalsta
Izvēles parametri:
- addr_ton — noklusējuma vērtība, ja iesniegšanas laikā TON ir iestatīts uz Nezināms.
- addr_npi — noklusējuma vērtība, ja iesniegšanas laikā NPI ir iestatīts uz Nezināms.
Neatbalstīti parametri:
- adreses_diapazons
4.2. Atsaistīt
Tiek atbalstīta atsaistīšanas komanda.
4.3. Uzziņas saite
Inquire link komanda tiek atbalstīta, un tā ir jāizsauc ik pēc 60 sekundēm.
4.4. Iesniegt
Ziņojumu piegādei jāizmanto iesniegšanas metode.
Nepieciešamie parametri:
- source_addr_ton
- source_addr_npi
- avota_adrese
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- datu_kodēšana
- sm_garums
- short_message
Neatbalstīti parametri:
- pakalpojuma_veids
- protokola_id
- prioritātes_karogs
- grafiks_piegādes_laiks
- aizstāt_ja_klāt_karodziņu
- sm_default_msg_id
Piezīme ka krava tag netiek atbalstīts, un vienam zvanam var tikt piegādāta tikai viena SMS, un ir ieteicams norādīt derīguma_periods tag tā vērtība ir vismaz 15 minūtes.
4.4.1. Ieteicamais TON un NPI
Sūtot ziņojumus, izmantojot komandu submit, ir jāizmanto šādi TON un NPI.
4.4.1.1 Avots
Avota adresei tiek atbalstītas šādas TON un NPI kombinācijas. Visas pārējās kombinācijas tiks uzskatītas par nederīgām. Ja TON ir iestatīts uz Nezināms (0), tiks izmantots saistīšanas komandas noklusējuma TON. Ja NPI ir iestatīts uz Nezināms (0), tiks izmantots saistīšanas komandas noklusējuma NPI.
| TON | NPI | Apraksts |
| Burtciparu (5) | Nezināms (0) ISDN (1) |
Tiks uzskatīts par burtciparu sūtītāja tekstu |
| Starptautiskā (1) | Nezināms (0) ISDN (1) |
Tiks uzskatīts par MSISDN |
| Valsts (2) Tīklam specifisks (3) Abonenta numurs (4) Saīsināts (6) |
Nezināms (0) ISDN (1) Valsts (8) |
Tiks uzskatīts par valstij specifisku īso numuru. |
4.4.1.2. Galamērķis
Galamērķa adresei tiek atbalstītas šādas TON un NPI kombinācijas. Visas pārējās kombinācijas tiks uzskatītas par nederīgām. Noklusējuma komanda TON from bind tiks izmantota, ja TON ir iestatīts uz Nezināms (0). Ja NPI ir iestatīts uz Nezināms (0), tiks izmantota noklusējuma komanda NPI from bind.
| TON | NPI | Apraksts |
| Starptautiskā (1) | Nezināms (0) ISDN (1) |
Tiks uzskatīts par MSISDN |
4.4.2. Atbalstītie kodējumi
Tiek atbalstīti šādi kodējumi. X var ietvert jebkuru vērtību.
| DCS | Kodēšana |
| 0xX0 | Noklusējuma GSM alfabēts ar paplašinājumu |
| 0xX2 | 8 bitu binārs |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Kvotas pārsniegšanaview
Kvota nosaka maksimālo īsziņu skaitu, ko var nosūtīt noteiktā laika intervālā (piemēram, dienā, nedēļā, mēnesī vai bezgalīgi). Katra kvota ir unikāli identificēta ar kvotas ID (UUID), un tā tiek atiestatīta atbilstoši klienta laika joslai. Kvotas var piešķirt valsts, reģiona vai noklusējuma līmenī, izmantojot Quota Pro.fileKvotu var piešķirt arī dinamiski, izmantojot kvotu kartēšanu. Tas sasaista vecāku kvotas ID (UUID) un unikālu kvotas atslēgu (piemēram, sūtītāju vai lietotāju) ar konkrētu kvotas ID.
Kvota tiek noteikta saskaņā ar jūsu vietējo atbalsta dienestu, jūsu norādīto konta pārvaldnieku vai pēc noklusējuma, ja nekas nav norādīts.
5.2 Statuss 106 — pārsniegta kvota
Īsziņa var tikt bloķēta ar statusa kodu 106 (“pārsniegta kvota”), ja:
- Ziņojums pārsniedz atbilstošā kvotas ID definēto ierobežojumu pašreizējā intervālā.
- Galamērķa valstij vai reģionam nav piešķirta kvota (t. i., tas ir skaidri bloķēts ar nulles kvotas kartējumu pakalpojumā).file).
- Nav atbilstošas kvotas un nav definēta noklusējuma kvota, kā rezultātā pieteikums tiek noraidīts.
Šādos gadījumos sistēma neļauj veikt turpmāku ziņojumu apstrādi, lai ieviestu klienta vai galamērķa ierobežojumus un novērstu ļaunprātīgu izmantošanu.
Piegādes atskaiti
Tiek atbalstīta tikai piegāde bez rezultātiem vai galīgā piegāde ar veiksmīgu/neveiksmīgu rezultātu.
Piegādes ziņojuma formāts: ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX DATUMS DATUMS: YYMMDDHHMM Stat:
Pieejamās vērtības statusā:
- PIEGĀDE
- BEIDZIS TERMIŅŠ
- NORAIDĪTS
- NEPIEGĀDĀT
- DZĒSTS
6.1. Paplašinātā piegādes atskaites formāts
Paplašinātu informāciju piegādes pārskatos var pieprasīt, sazinoties ar tirdzniecības pārstāvi.
Piegādes pārskata formāts: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 iesniegšanas datums:
ggMMddHHmm pabeigšanas datums: ggMMddHHmm statistika: kļūda: teksts:
Pieejamās vērtības statusā:
- PIEGĀDE
- BEIDZIS TERMIŅŠ
- NORAIDĪTS
- NEPIEGĀDĀT
- DZĒSTS
Lauki “sub” un “dlvrd” vienmēr tiks iestatīti uz 000, un lauks “text” vienmēr būs tukšs.
Skatiet nodaļu Kļūdu kodi lauku “err” vērtībām.
Atbalstītās TLS versijas
TLS 1.2 vai TLS 1.3 ir nepieciešams visiem TLS savienojumiem, izmantojot SMPP.
TLS 1.0 un 1.1 atbalsts tiek pārtraukts kopš 2020. 11. TLS versijas 15 un 1.0 ir vecāki protokoli, kas ir novecojuši un tiek uzskatīti par drošības riskiem interneta kopienā.
LINK ļoti iesakām izmantot TLS, ja šodien tiek izmantoti nešifrēti SMPP savienojumi. LINK nešifrētie SMPP savienojumi ir novecojuši no 2020-09-01, un tie nākotnē tiks noņemti. Nešifrēto savienojumu noņemšanas datums vēl nav noteikts.
Savienojumi ar SMPP serveri TLS ir 3601. portā, nevis nešifrēti portā 3600.
Jūs joprojām varat izmantot TLS, pat ja jūsu SMPP implementācija neatbalsta TLS, izmantojot stunnel, sk https://www.stunnel.org/
Kļūdu kodi
Ja lauks ir iespējots, kļūdas laukā var tikt parādīti šādi kļūdu kodi.
| Kļūdas kods | Apraksts |
| 0 | Nezināma kļūda |
| 1 | Pagaidu maršrutēšanas kļūda |
| 2 | Pastāvīga maršrutēšanas kļūda |
| 3 | Pārsniegta maksimālā drosele |
| 4 | Taimauts |
| 5 | Operatora nezināma kļūda |
| 6 | Operatora kļūda |
| 100 | Pakalpojums nav atrasts |
| 101 | Lietotājs nav atrasts |
| 102 | Konts nav atrasts |
| 103 | Nepareiza parole |
| 104 | Konfigurācijas kļūda |
| 105 | Iekšēja kļūda |
| 106 | Kvota pārsniegta |
| 200 | OK |
| 1000 | Nosūtīts |
| 1001 | Piegādāts |
| 1002 | Beidzies derīguma termiņš |
| 1003 | Izdzēsts |
| 1004 | Pilns mobilais |
| 1005 | Rindā |
| 1006 | Nav piegādāts |
| 1007 | Piegādāts, samaksa aizkavējusies |
| 1008 | Uzlādēts, ziņa nav nosūtīta |
| 1009 | Maksa, ziņa nav piegādāta |
| 1010 | Derīguma termiņš beidzies, operatora piegādes atskaites nav |
| 1011 | Maksa, ziņa nosūtīta (operatoram) |
| 1012 | Attālināti rindā |
| 1013 | Ziņojums nosūtīts operatoram, uzlāde aizkavējās |
| 2000 | Nederīgs avota numurs |
| 2001 | Īsais numurs netiek atbalstīts kā avots |
| 2002 | Alfa netiek atbalstīta kā avots |
| 2003 | MSISDN netiek atbalstīts kā avota numurs |
| 2100 | Īsais numurs netiek atbalstīts kā galamērķis |
| 2101 | Alfa netiek atbalstīta kā galamērķis |
| 2102 | MSISDN netiek atbalstīts kā galamērķis |
| 2103 | Darbība bloķēta |
| 2104 | Nezināms abonents |
| 2105 | Galamērķis ir bloķēts |
| 2106 | Numura kļūda |
| 2107 | Galamērķis īslaicīgi bloķēts |
| 2108 | Nederīgs galamērķis |
| 2200 | Uzlādes kļūda |
| 2201 | Abonentam ir zems atlikums |
|
2202 |
Abonents bloķēts par pārmaksātu maksu (premium)
ziņas |
|
2203 |
Abonents ir pārāk jauns (šim konkrētajam gadījumam)
saturs) |
| 2204 | Priekšapmaksas abonents nav atļauts |
| 2205 | Abonents noraidīja pakalpojumu |
| 2206 | Abonents nav reģistrēts maksājumu sistēmā |
| 2207 | Abonents ir sasniedzis maksimālo atlikumu |
| 2208 | Nepieciešams gala lietotāja apstiprinājums |
| 2300 | Atmaksāts |
|
2301 |
Nevarēja atmaksāt nelikumīgas vai trūkstošas preces dēļ
MSISDN |
| 2302 | Nevarēja atmaksāt, jo trūkst ziņojuma ID |
| 2303 | Iestājās rindā uz atmaksu |
| 2304 | Atmaksas noildze |
| 2305 | Atmaksas neveiksme |
| 3000 | GSM kodējums netiek atbalstīts |
| 3001 | UCS2 kodējums netiek atbalstīts |
| 3002 | Binārais kodējums netiek atbalstīts |
| 4000 | Piegādes atskaite netiek atbalstīta |
| 4001 | Nederīgs ziņojuma saturs |
| 4002 | Nederīgs tarifs |
| 4003 | Nederīgi lietotāja dati |
| 4004 | Nederīga lietotāja datu galvene |
| 4005 | Nederīgs datu kodējums |
| 4006 | Nederīgs PVN |
| 4007 | Neatbalstīts saturs galamērķim |
Dokumenti / Resursi
 |
saišu mobilitātes SMS API, SMPP API MS plānotāja API [pdfLietotāja rokasgrāmata SMS API SMPP API MS plānotāja API, SMS API SMPP API, MS plānotāja API, plānotāja API, API |