SMS API,SMPP API MS Scheduler API
Gwida għall-Utent
SMS API,SMPP API MS Scheduler API
| Modifikat: | 6/24/2025 |
| Verżjoni: | 1.7 |
| Awtur: | Kenny Colander Norden, KCN |
Dan id-dokument huwa għar-riċevitur magħżul biss u jista' jkun fih informazzjoni privileġġjata, proprjetarja, jew b'xi mod ieħor privata. Jekk irċevejtha bi żball, jekk jogħġbok avża lill-mittent immedjatament u ħassar l-oriġinal. Kwalunkwe użu ieħor tad-dokument minnek huwa pprojbit.
Ibdel l-istorja
| Rev | Data | By | Bidliet minn rilaxx preċedenti |
| 1.0 | 2010-03-16 | KCN | Maħluq |
| 1. | 2019-06-11 | TPE | Logos LINK aġġornati |
| 1. | 2019-09-27 | PNI | Referenza miżjuda għall-ispeċifikazzjoni SMPP 3.4 |
| 1. | 2019-10-31 | EP | Osservazzjoni dwar il-perjodu ta' validità tag |
| 1. | 2020-08-28 | KCN | Miżjud informazzjoni dwar verżjonijiet TLS appoġġjati |
| 2. | 2022-01-10 | KCN | Żidna informazzjoni addizzjonali dwar ir-rapporti tal-kunsinna Informazzjoni aġġornata dwar TLS 1.3 |
| 2. | 2025-06-03 | GM | Żied il-kodiċi tar-riżultat 2108 |
| 2. | 2025-06-24 | AK | Kwota miżjuda |
Introduzzjoni
LINK Mobility ilha distributur tal-SMS mill-2001 u għandha ħafna esperjenza fil-ħidma kemm mal-operaturi kif ukoll mal-aggregaturi tal-konnessjoni. Din il-pjattaforma hija ddisinjata biex timmaniġġja volumi kbar ta’ traffiku, iżżomm disponibbiltà għolja u tagħmilha faċli biex it-traffiku jiġi rotta permezz ta’ konnessjonijiet multipli.
Dan id-dokument jiddeskrivi l-interfaċċja tal-SMPP għall-pjattaforma SMSC u liema parametri u kmandi huma meħtieġa u liema parametri huma appoġġjati.
Dan id-dokument mhux se jittratta każijiet ta' użu speċifiċi bħal messaġġi kkonkatenati, WAPpush, Flash SMS, eċċ. Aktar informazzjoni dwar dawk il-każijiet tista' tiġi pprovduta billi tikkuntattja l-appoġġ.
Kmandi appoġġjati
Is-server ta' LINK Mobility għandu jiġi ttrattat bħala SMPP 3.4. L-ispeċifikazzjoni uffiċjali tinsab fuq https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Il-metodi kollha mhumiex appoġġjati, u d-differenzi kollha huma speċifikati hawn taħt.
4.1 Irbit
Il-kmandi tal-bind li ġejjin huma appoġġjati.
- Trasmettitur
- transciever
- Riċevitur
Parametri meħtieġa:
- system_id – miksub mill-appoġġ
- password – miksuba mill-appoġġ
Parametri mhux obbligatorji:
- addr_ton – valur default jekk TON huwa ssettjat għal Mhux magħruf waqt is-sottomissjoni.
- addr_npi – valur default jekk NPI huwa ssettjat għal Mhux magħruf waqt is-sottomissjoni.
Parametri mhux appoġġjati:
- address_range
4.2 Ħoll
Il-kmand tal-unbind huwa appoġġjat.
4.3 Inkjesta link
Il-kmand tal-link inquire huwa appoġġjat u għandu jissejjaħ kull 60 sekonda.
4.4 Issottometti
Il-metodu ta' sottomissjoni għandu jintuża għat-twassil ta' messaġġi.
Parametri meħtieġa:
- source_addr_ton
- source_addr_npi
- indirizz_sors
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- messaġġ_qasir
Parametri mhux appoġġjati:
- tip_servizz
- protocol_id
- prijorità_bandiera
- schedule_delivery_time
- ibdel_jekk_present_flag
- sm_default_msg_id
Nota li t-tagħbija tag mhux appoġġjat u SMS wieħed biss jista' jiġi kkonsenjat għal kull sejħa u huwa rakkomandat li validity_period tag għandu valur ta' mill-inqas 15-il minuta.
4.4.1 TON u NPI Rakkomandati
It-TON u l-NPI li ġejjin għandhom jintużaw meta jintbagħtu messaġġi bl-użu tal-kmand tas-sottomissjoni.
4.4.1.1 Sors
Il-kombinazzjonijiet TON u NPI li ġejjin huma appoġġjati għall-indirizz tas-sors. Il-kombinazzjonijiet l-oħra kollha se jiġu ttrattati bħala invalidi. It-TON awtomatiku mill-kmand bind se jintuża jekk TON ikun issettjat għal Mhux Magħruf (0). L-NPI awtomatiku mill-kmand bind se jintuża jekk NPI jkun issettjat għal Mhux Magħruf (0).
| TON | NPI | Deskrizzjoni |
| Alfanumeriku (5) | Mhux magħruf (0) ISDN (1) |
Se jiġi ttrattat bħala test alfanumeriku tal-mittent |
| Internazzjonali (1) | Mhux magħruf (0) ISDN (1) |
Se jiġi ttrattat bħala MSISDN |
| Nazzjonali (2) Speċifiku għan-netwerk (3) Numru tal-abbonat (4) Imqassar (6) |
Mhux magħruf (0) ISDN (1) Nazzjonali (8) |
Se jiġi ttrattat bħala numru qasir speċifiku għall-pajjiż. |
4.4.1.2 Destinazzjoni
Il-kombinazzjonijiet TON u NPI li ġejjin huma appoġġjati għall-indirizz tad-destinazzjoni. Il-kombinazzjonijiet l-oħra kollha se jiġu ttrattati bħala invalidi. It-TON default mill-kmand tal-bind se jintuża jekk TON ikun issettjat għal Mhux magħruf (0). L-NPI default mill-kmand tal-bind se jintuża jekk l-NPI huwa ssettjat għal Mhux magħruf (0).
| TON | NPI | Deskrizzjoni |
| Internazzjonali (1) | Mhux magħruf (0) ISDN (1) |
Se jiġi ttrattat bħala MSISDN |
4.4.2 Kodifikazzjonijiet appoġġjati
Il-kodifikazzjonijiet li ġejjin huma appoġġjati. X jista' jkun fih kwalunkwe valur.
| DCS | Kodifikazzjoni |
| 0xX0 | Alfabett GSM default b'estensjoni |
| 0xX2 | 8-bit binarju |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kwota
5.1 Kwota 'l fuqview
Kwota tiddefinixxi l-għadd massimu ta' messaġġi SMS li jistgħu jintbagħtu f'intervall ta' żmien speċifikat (bħal kuljum, ġimgħa, xahar, jew b'mod indefinit). Kull kwota hija identifikata b'mod uniku minn quotaId (UUID) u tiġi rrisettjata skont iż-żona tal-ħin tal-klijent. Il-kwoti jistgħu jiġu assenjati fil-livell tal-pajjiż, tar-reġjun, jew awtomatiku permezz ta' Quota Pro.fileIl-kwota tista' wkoll tiġi assenjata b'mod dinamiku bl-użu tal-Quota Mapping. Dan jimmappa QuotaId prinċipali (UUID) u Ċavetta unika tal-kwota (eż., mittent jew utent) ma' quotaId speċifika.
Kwota tiġi stabbilita skont l-appoġġ lokali tiegħek, il-maniġer tal-kont assenjat tiegħek jew awtomatikament jekk ma jkun speċifikat xejn.
5.2 Status 106 – Kwota Maqbuża
Messaġġ SMS jista' jiġi mblukkat bil-kodiċi tal-istatus 106 (“kwota maqbuża”) meta:
- Il-messaġġ jaqbeż il-limitu definit għall-quotaId korrispondenti tiegħu fl-intervall attwali.
- Il-pajjiż jew ir-reġjun tad-destinazzjoni m'għandu l-ebda kwota assenjata (jiġifieri, huwa mblukkat espliċitament b'immappjar ta' kwota nulla fil-profile).
- M'hemm l-ebda kwota li taqbel u l-ebda kwota awtomatika mhija definita, u dan jirriżulta f'rifjut.
F'dawn il-każijiet, is-sistema tipprevjeni aktar ipproċessar ta' messaġġi biex tinforza limiti bbażati fuq il-klijent jew id-destinazzjoni u tevita użu ħażin.
Rapport tal-kunsinna
L-ebda waħda biss jew il-kunsinna finali b'riżultat ta' suċċess/falliment hija appoġġjata.
Format tar-rapport tal-kunsinna: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx data li saret: yyMMddHHmm stat:
Valuri disponibbli fl-istatus:
- DELIVRD
- SKADUTA
- MIĊĦUTD
- UNDELIV
- MĦASSRA
6.1 Format tar-rapport tal-kunsinna estiż
Informazzjoni estiża fir-rapporti tal-kunsinna tista' tintalab f'kuntatt mar-rappreżentant tal-bejgħ tiegħek.
Format tar-rapport tal-kunsinna: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 data tas-sottomissjoni:
data ta' skadenza ssMMddHHmm: stat ssMMddHHmm: żball: test:
Valuri disponibbli fl-istatus:
- DELIVRD
- SKADUTA
- MIĊĦUTD
- UNDELIV
- MĦASSRA
L-oqsma "sub" u "dlvrd" dejjem se jkunu ssettjati għal 000, u l-qasam "test" dejjem ikun vojt.
Ara l-kapitolu Kodiċi ta' żball għall-valuri għall-qasam “err”.
Verżjonijiet TLS appoġġjati
TLS 1.2 jew TLS 1.3 huma meħtieġa għall-konnessjonijiet TLS kollha fuq SMPP.
L-appoġġ għal TLS 1.0 u 1.1 twaqqaf mill-2020-11-15. Il-verżjonijiet 1.0 u 1.1 tat-TLS huma protokolli eqdem li ġew deprecati u huma kkunsidrati bħala riskji għas-sigurtà fil-komunità tal-Internet.
LINK jirrakkomanda bil-qawwa li tuża TLS jekk illum qed jintużaw konnessjonijiet SMPP mhux encrypted. Konnessjonijiet SMPP mhux kriptati huma deprecati mill-2020-09-01 minn LINK, u se jitneħħew fil-futur. Id-data għat-tneħħija ta' konnessjonijiet mhux kriptati għadha mhix deċiża.
Konnessjonijiet lejn is-server SMPP għat-TLS jinsabu fil-port 3601 minflok mhux kriptat fil-port 3600.
Inti xorta tista 'tuża TLS anki jekk l-implimentazzjoni SMPP tiegħek ma tappoġġjax TLS bl-użu ta' stunnel, ara https://www.stunnel.org/
Kodiċi ta' żball
Il-kodiċijiet ta' żball li ġejjin jistgħu jiġu mwieġba fil-qasam ta' żball jekk il-qasam ikun attivat.
| Kodiċi ta' żball | Deskrizzjoni |
| 0 | Żball mhux magħruf |
| 1 | Żball temporanju tar-rotta |
| 2 | Żball permanenti fir-rotta |
| 3 | Inqabeż it-throttling massimu |
| 4 | Timeout |
| 5 | Żball mhux magħruf tal-operatur |
| 6 | Żball tal-operatur |
| 100 | Servizz ma nstabx |
| 101 | Utent ma nstabx |
| 102 | Kont ma nstabx |
| 103 | Password mhux valida |
| 104 | Żball tal-konfigurazzjoni |
| 105 | Żball intern |
| 106 | Kwota maqbuża |
| 200 | OK |
| 1000 | Mibgħuta |
| 1001 | Mogħtija |
| 1002 | Skaduta |
| 1003 | Imħassar |
| 1004 | Mobile sħiħ |
| 1005 | Fil-kju |
| 1006 | Mhux imwassla |
| 1007 | Mogħtija, ħlas ittardjat |
| 1008 | Iċċarġjat, messaġġ mhux mibgħut |
| 1009 | Iċċarġjat, messaġġ mhux ikkunsinnat |
| 1010 | Skaduta, nuqqas ta' rapport tal-kunsinna tal-operatur |
| 1011 | Iċċarġjat, messaġġ mibgħut (lill-operatur) |
| 1012 | Imqiegħed fil-kju mill-bogħod |
| 1013 | Messaġġ mibgħut lill-operatur, iċċarġjar ittardjat |
| 2000 | Numru tas-sors mhux validu |
| 2001 | Numru qasir mhuwiex appoġġjat bħala sors |
| 2002 | Alpha mhux appoġġjat bħala sors |
| 2003 | MSISDN mhuwiex appoġġjat bħala numru tas-sors |
| 2100 | Numru qasir mhuwiex appoġġjat bħala destinazzjoni |
| 2101 | Alpha mhux appoġġjat bħala destinazzjoni |
| 2102 | MSISDN mhux appoġġjat bħala destinazzjoni |
| 2103 | Operazzjoni imblukkata |
| 2104 | Abbonat mhux magħruf |
| 2105 | Destinazzjoni imblukkata |
| 2106 | Żball numru |
| 2107 | Destinazzjoni temporanjament imblukkata |
| 2108 | Destinazzjoni invalida |
| 2200 | Żball fl-iċċarġjar |
| 2201 | L-abbonat għandu bilanċ baxx |
|
2202 |
Abbonat ipprojbit għal ħlas żejjed (premium)
messaġġi |
|
2203 |
Abbonat żgħir wisq (għal dan il-punt partikolari)
kontenut) |
| 2204 | Abbonat imħallas minn qabel mhux permess |
| 2205 | Servizz miċħud mill-abbonat |
| 2206 | Abbonat mhux reġistrat fis-sistema tal-ħlas |
| 2207 | L-abbonat laħaq bilanċ massimu |
| 2208 | Konferma tal-utent aħħari meħtieġa |
| 2300 | Rifużjoni |
|
2301 |
Ma stajtx nirrifonda minħabba illegali jew nieqes
MSISDN |
| 2302 | Ma setax jirrifondi minħabba messaġġId nieqes |
| 2303 | Fil-kju għar-rifużjoni |
| 2304 | Timeout tar-rifużjoni |
| 2305 | Nuqqas ta' rifużjoni |
| 3000 | Il-kodifikazzjoni GSM mhix appoġġjata |
| 3001 | Il-kodifikazzjoni UCS2 mhix appoġġjata |
| 3002 | Kodifikazzjoni binarja mhix appoġġjata |
| 4000 | Ir-rapport tal-kunsinna mhuwiex appoġġjat |
| 4001 | Kontenut tal-messaġġ mhux validu |
| 4002 | Tariffa mhux valida |
| 4003 | Data tal-utent mhux valida |
| 4004 | Intestatura tad-dejta tal-utent mhux valida |
| 4005 | Kodifikazzjoni tad-dejta invalida |
| 4006 | VAT invalida |
| 4007 | Kontenut mhux appoġġjat għad-destinazzjoni |
Dokumenti / Riżorsi
 |
link mobilità SMS API,SMPP API MS Scheduler API [pdfGwida għall-Utent SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |