SMS API, SMPP API MS Scheduler API
Udhëzues përdorimi
SMS API, SMPP API MS Scheduler API
| Ndryshuar: | 6/24/2025 |
| Versioni: | 1.7 |
| Autori: | Kenny Colander Norden, KCN |
Ky dokument është vetëm për marrësin e caktuar dhe mund të përmbajë informacione të privilegjuara, pronësore ose ndryshe private. Nëse e keni marrë gabimisht, ju lutemi njoftoni menjëherë dërguesin dhe fshini origjinalin. Çdo përdorim tjetër i dokumentit nga ju është i ndaluar.
Ndrysho historinë
| Rev | Data | By | Ndryshime nga versioni i mëparshëm |
| 1.0 | 2010-03-16 | KCN | Krijuar |
| 1. | 2019-06-11 | TPE | Logot e LINK të përditësuara |
| 1. | 2019-09-27 | PNI | Referenca e shtuar për specifikimin SMPP 3.4 |
| 1. | 2019-10-31 | EP | Vëzhgimi për periudhën e vlefshmërisë tag |
| 1. | 2020-08-28 | KCN | Informacion i shtuar në lidhje me versionet e mbështetura TLS |
| 2. | 2022-01-10 | KCN | Added additional information regarding delivery reports Updated information regarding TLS 1.3 |
| 2. | 2025-06-03 | GM | Added result code 2108 |
| 2. | 2025-06-24 | AK | Added quota |
Hyrje
LINK Mobility është distributor i SMS-ve që nga viti 2001 dhe ka shumë përvojë në punën si me operatorët ashtu edhe me grumbulluesit e lidhjeve. Kjo platformë është krijuar për të trajtuar vëllime të mëdha trafiku, për të mbajtur një disponueshmëri të lartë dhe për ta bërë të lehtë drejtimin e trafikut nëpërmjet lidhjeve të shumta.
Ky dokument përshkruan ndërfaqen SMPP me platformën SMSC dhe cilët parametra dhe komanda kërkohen dhe cilët parametra mbështeten.
This document will not handle specific use cases as concatenated messages, WAPpush, Flash SMS, etc. More information about those cases can be provided by contacting support.
Komandat e mbështetura
Serveri i LINK Mobility duhet të trajtohet si SMPP 3.4. Specifikimi zyrtar mund të gjendet në https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Të gjitha metodat nuk mbështeten dhe të gjitha ndryshimet janë të specifikuara më poshtë.
4.1 Lidh
Komandat e mëposhtme të lidhjes mbështeten.
- Transmetues
- transciver
- Marrësi
Parametrat e kërkuar:
- system_id – marrë nga mbështetja
- fjalëkalimi - marrë nga mbështetja
Parametrat opsionalë:
- addr_ton – vlera e paracaktuar nëse TON vendoset në Unknown gjatë dorëzimit.
- addr_npi – vlera e paracaktuar nëse NPI vendoset në Unknown gjatë dorëzimit.
Parametrat e pambështetur:
- diapazoni i adresës
4.2 Çlidh
Komanda unbind mbështetet.
4.3 Lidhja e pyetjes
Komanda e lidhjes kërkimore mbështetet dhe duhet të thirret çdo 60 sekonda.
4.4 Paraqisni
Metoda e dërgimit duhet të përdoret për dërgimin e mesazheve.
Parametrat e kërkuar:
- burim_addr_ton
- burim_addr_npi
- burim_shtimi
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- kodimi i të dhënave
- gjatësi_sm
- mesazh i shkurter
Parametrat e pambështetur:
- lloji i shërbimit
- protokol_id
- prioritet_flamuri
- orari_koha_dorëzimi
- zëvendësoj_nëse_flamuri_i pranishëm
- sm_default_msg_id
Shënim se ngarkesa tag nuk mbështetet dhe mund të dërgohet vetëm një SMS për çdo telefonatë dhe rekomandohet që periudha_vlefshmërie tag ka një vlerë prej të paktën 15 minutash.
4.4.1 TON dhe NPI i rekomanduar
TON dhe NPI në vijim duhet të përdoren kur dërgoni mesazhe duke përdorur komandën e dërgimit.
4.4.1.1 Burimi
The following TON and NPI combinations are supported for source address. All other combinations will be treated as invalid. The default TON from bind command will be used if TON is set to Unknown (0). The default NPI from bind command will be used if NPI is set to Unknown (0).
| TON | NPI | Përshkrimi |
| Alfanumerik (5) | E panjohur (0) ISDN (1) |
Do të trajtohet si tekst alfanumerik i dërguesit |
| Ndërkombëtare (1) | E panjohur (0) ISDN (1) |
Do të trajtohet si MSISDN |
| Kombëtare (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
E panjohur (0) ISDN (1) Kombëtare (8) |
Do të trajtohet si numër i shkurtër specifik për vendin. |
4.4.1.2 Destinacioni
Kombinimet e mëposhtme TON dhe NPI mbështeten për adresën e destinacionit. Të gjitha kombinimet e tjera do të trajtohen si të pavlefshme. Komanda e paracaktuar TON nga bind do të përdoret nëse TON vendoset në Unknown (0). Komanda e paracaktuar NPI nga bind do të përdoret nëse NPI vendoset në Unknown (0).
| TON | NPI | Përshkrimi |
| Ndërkombëtare (1) | E panjohur (0) ISDN (1) |
Do të trajtohet si MSISDN |
4.4.2 Enkodimet e mbështetura
Mbështeten kodimet e mëposhtme. X mund të përmbajë çdo vlerë.
| DCS | Kodimi |
| 0xX0 | Alfabeti i parazgjedhur GSM me zgjerim |
| 0xX2 | Binar 8-bit |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kuota
5.1 Kuota Mbiview
A quota defines the maximum number of SMS messages that can be sent within a specified time interval (such as per day, week, month, or indefinitely). Each quota is uniquely identified by a quotaId (UUID) and is reset according to the customer’s time zone. Quotas can be assigned at the country, region, or default level through a Quota Profile. Quota can also be dynamically assigned using Quota Mapping. This maps a parent QuotaId (UUID) and a unique quota Key (e.g., sender or user) to a specific quotaId.
Një kuotë caktohet në përputhje me mbështetjen tuaj lokale, menaxherin e llogarisë suaj të caktuar ose si parazgjedhje nëse nuk specifikohet asgjë.
5.2 Status 106 – Quota Exceeded
An SMS message may be blocked with status code 106 (“quota exceeded”) when:
- The message exceeds the defined limit for its corresponding quotaId within the current interval.
- The destination country or region has no quota assigned (i.e., is explicitly blocked with a null quota mapping in the profile).
- There is no matching quota and no default quota is defined, resulting in rejection.
Në këto raste, sistemi parandalon përpunimin e mëtejshëm të mesazheve për të zbatuar kufizimet e bazuara në klient ose destinacion dhe për të shmangur keqpërdorimin.
Raporti i dorëzimit
Mbështetet vetëm asnjë ose dërgesa përfundimtare me rezultat të suksesshëm/dështuar.
Formati në Raportin e Dorëzimit: ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX DANI DATA: YYMMDDHHMM STAT:
Vlerat e disponueshme në status:
- DELIVRD
- I SKADUAR
- REFUZOHET
- UNDELIV
- Fshirë
6.1 Formati i zgjeruar i raportit të dorëzimit
Informacioni i zgjeruar në raportet e dorëzimit mund të kërkohet në kontakt me përfaqësuesin tuaj të shitjeve.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Vlerat e disponueshme në status:
- DELIVRD
- I SKADUAR
- REFUZOHET
- UNDELIV
- Fshirë
Fushat "sub" dhe "dlvrd" do të vendosen gjithmonë në 000 dhe fusha "tekst" do të jetë gjithmonë bosh.
Shihni kapitullin Kodet e gabimit për vlerat për fushën "gabim".
Versionet e mbështetura TLS
TLS 1.2 ose TLS 1.3 kërkohet për të gjitha lidhjet TLS mbi SMPP.
Mbështetja për TLS 1.0 dhe 1.1 është ndërprerë që nga 2020-11-15. Versionet 1.0 dhe 1.1 të TLS janë protokolle më të vjetra që janë vjetëruar dhe konsiderohen si rreziqe sigurie në komunitetin e internetit.
LINK rekomandon fuqimisht përdorimin e TLS nëse sot përdoren lidhje të pakriptuara SMPP. Lidhjet e pakriptuara SMPP janë zhvlerësuar që nga 2020-09-01 nga LINK dhe do të hiqen në të ardhmen. Data e heqjes së lidhjeve të pakriptuara ende nuk është vendosur.
Lidhjet drejt serverit SMPP për TLS janë në portin 3601 në vend që të jenë të pakriptuara në portin 3600.
Mund të përdorni akoma TLS edhe nëse zbatimi juaj SMPP nuk e mbështet TLS duke përdorur stunnel, shih https://www.stunnel.org/
Kodet e gabimit
Kodet e mëposhtme të gabimit mund të përgjigjen në fushën e gabimit nëse fusha është e aktivizuar.
| Kodi i gabimit | Përshkrimi |
| 0 | Gabim i panjohur |
| 1 | Gabim i përkohshëm i rrugëzimit |
| 2 | Gabim i përhershëm i rrugëtimit |
| 3 | Mbyllja maksimale është tejkaluar |
| 4 | Kohëzgjatja |
| 5 | Gabim i panjohur i operatorit |
| 6 | Gabim operatori |
| 100 | Shërbimi nuk u gjet |
| 101 | Përdoruesi nuk u gjet |
| 102 | Llogaria nuk u gjet |
| 103 | Fjalëkalim i pavlefshëm |
| 104 | Gabim konfigurimi |
| 105 | Gabim i brendshëm |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Dërguar |
| 1001 | Dorëzuar |
| 1002 | I skaduar |
| 1003 | Fshirë |
| 1004 | Celulari plot |
| 1005 | Në radhë |
| 1006 | Nuk është dorëzuar |
| 1007 | U dorëzua, tarifimi u vonua |
| 1008 | I ngarkuar, mesazhi nuk u dërgua |
| 1009 | I tarifuar, mesazhi nuk u dërgua |
| 1010 | Ka skaduar, mungesa e raportit të dorëzimit të operatorit |
| 1011 | I tarifuar, mesazhi i dërguar (operatorit) |
| 1012 | Në radhë në distancë |
| 1013 | Mesazhi i dërguar operatorit, tarifimi është vonuar |
| 2000 | Numër burimi i pavlefshëm |
| 2001 | Numri i shkurtër nuk mbështetet si burim |
| 2002 | Alpha nuk mbështetet si burim |
| 2003 | MSISDN nuk mbështetet si numër burimi |
| 2100 | Numri i shkurtër nuk mbështetet si destinacion |
| 2101 | Alpha nuk mbështetet si destinacion |
| 2102 | MSISDN nuk mbështetet si destinacion |
| 2103 | Operacioni u bllokua |
| 2104 | Abonent i panjohur |
| 2105 | Destinacioni u bllokua |
| 2106 | Gabim në numër |
| 2107 | Destinacioni u bllokua përkohësisht |
| 2108 | Invalid destination |
| 2200 | Gabim karikimi |
| 2201 | Abonenti ka bilanc të ulët |
|
2202 |
Subscriber barred for overcharged (premium)
mesazhe |
|
2203 |
Subscriber too young (for this particular
përmbajtja) |
| 2204 | Abonenti me parapagesë nuk lejohet |
| 2205 | Shërbimi i refuzuar nga pajtimtari |
| 2206 | Abonenti nuk është i regjistruar në sistemin e pagesave |
| 2207 | Abonenti ka arritur balancën maksimale |
| 2208 | Nevojitet konfirmimi i përdoruesit përfundimtar |
| 2300 | Rimbursohet |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Nuk mund të rimbursohej për shkak të mesazhit të humbur |
| 2303 | Në radhë për rimbursim |
| 2304 | Afati i rimbursimit |
| 2305 | Dështimi i rimbursimit |
| 3000 | Kodimi GSM nuk mbështetet |
| 3001 | Kodimi UCS2 nuk mbështetet |
| 3002 | Kodimi binar nuk mbështetet |
| 4000 | Raporti i dorëzimit nuk mbështetet |
| 4001 | Përmbajtje e pavlefshme e mesazhit |
| 4002 | Tarifa e pavlefshme |
| 4003 | Të dhëna të pavlefshme të përdoruesit |
| 4004 | Titulli i pavlefshëm i të dhënave të përdoruesit |
| 4005 | Kodimi i pavlefshëm i të dhënave |
| 4006 | TVSH e pavlefshme |
| 4007 | Përmbajtje e pambështetur për destinacion |
Dokumentet / Burimet
 |
lëvizshmëria e lidhjes SMS API, SMPP API MS Scheduler API [pdfUdhëzuesi i përdoruesit SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |