SMS API, SMPP API MS Scheduler API
Notendahandbók
SMS API, SMPP API MS Scheduler API
| Breytt: | 6/24/2025 |
| Útgáfa: | 1.7 |
| Höfundur: | Kenny Colander Norden, KCN |
Þetta skjal er eingöngu ætlað tilnefndum viðtakanda og getur innihaldið forréttindaupplýsingar, einkaupplýsingar eða á annan hátt persónulegar upplýsingar. Ef þú hefur fengið það fyrir mistök, vinsamlegast láttu sendanda vita strax og eyða frumritinu. Öll önnur notkun þín á skjalinu er bönnuð.
Breyta sögu
| sr | Dagsetning | By | Breytingar frá fyrri útgáfu |
| 1.0 | 2010-03-16 | KCN | Búið til |
| 1. | 2019-06-11 | TPE | Uppfært LINK lógó |
| 1. | 2019-09-27 | PNI | Bætt við tilvísun í SMPP 3.4 forskrift |
| 1. | 2019-10-31 | EP | Athugun um gildistíma tag |
| 1. | 2020-08-28 | KCN | Bætt við upplýsingum um studdar TLS útgáfur |
| 2. | 2022-01-10 | KCN | Bætti við viðbótarupplýsingum varðandi afhendingarskýrslur Uppfærðar upplýsingar varðandi TLS 1.3 |
| 2. | 2025-06-03 | GM | Bætt við niðurstöðukóða 2108 |
| 2. | 2025-06-24 | AK | Bætt við kvóta |
Inngangur
LINK Mobility hefur verið sms-dreifingaraðili síðan 2001 og hefur mikla reynslu af því að vinna með bæði rekstraraðilum og tengingarsöfnunaraðilum. Þessi vettvangur er hannaður til að takast á við mikið umferðarmagn, viðhalda miklu framboði og gera það auðvelt að beina umferð um margar tengingar.
Þetta skjal lýsir SMPP viðmótinu við SMSC-kerfið og hvaða breytur og skipanir eru nauðsynlegar og hvaða breytur eru studdar.
Þetta skjal fjallar ekki um tiltekin notkunartilvik eins og samtengd skilaboð, WAPpush, Flash SMS o.s.frv. Nánari upplýsingar um þessi tilvik er að finna með því að hafa samband við þjónustudeild.
Stuðar skipanir
Meðhöndla skal netþjón LINK Mobility sem SMPP 3.4. Opinberu forskriftina má finna á https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Allar aðferðir eru ekki studdar og allur munur er tilgreindur hér að neðan.
4.1 Bind
Eftirfarandi bindiskipanir eru studdar.
- Sendandi
- Senditæki
- Móttökutæki
Nauðsynlegar færibreytur:
- system_id – fengin frá stuðningi
- lykilorð – fengið frá þjónustudeild
Valfrjálsar breytur:
- addr_ton – sjálfgefið gildi ef TON er stillt á Óþekkt við sendingu.
- addr_npi – sjálfgefið gildi ef NPI er stillt á Óþekkt við sendingu.
Óstuddar færibreytur:
- heimilisfang_svið
4.2 Afbinda
Unbind skipunin er studd.
4.3 Fyrirspurnartengil
Fyrirspurnartengilskipunin er studd og ætti að hringja í hana á 60 sekúndna fresti.
4.4 Senda inn
Nota skal sendingaraðferðina til að koma skilaboðum til skila.
Nauðsynlegar færibreytur:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- gagnakóðun
- sm_lengd
- stutt_skilaboð
Óstuddar færibreytur:
- þjónustugerð
- protocol_id
- forgangsfáni
- áætlun_afhendingartími
- skipta út_ef_til staðar_fánans
- sm_default_msg_id
Athugið að farmurinn tag er ekki stutt og aðeins er hægt að senda eitt SMS í hvert símtal og mælt er með því að gildistími tag hefur gildið að minnsta kosti 15 mínútur að lengd.
4.4.1 Mælt er með TON og NPI
Eftirfarandi TON og NPI ætti að nota þegar skilaboð eru send með send skipun.
4.4.1.1 Heimild
Eftirfarandi TON og NPI samsetningar eru studdar fyrir upprunavistfang. Allar aðrar samsetningar verða meðhöndlaðar sem ógildar. Sjálfgefin TON frá bind skipun verður notuð ef TON er stillt á Óþekkt (0). Sjálfgefin NPI frá bind skipun verður notuð ef NPI er stillt á Óþekkt (0).
| TONN | NPI | Lýsing |
| Bókstafa (5) | Óþekkt (0) ISDN (1) |
Verður meðhöndluð sem alstafanlegur sendandi texti |
| Alþjóðlegt (1) | Óþekkt (0) ISDN (1) |
Verður meðhöndlað sem MSISDN |
| National (2) Sértækt net (3) Áskrifendanúmer (4) Stytt (6) |
Óþekkt (0) ISDN (1) National (8) |
Verður meðhöndlað sem landsbundið stutt númer. |
4.4.1.2 Áfangastaður
Eftirfarandi TON og NPI samsetningar eru studdar fyrir áfangastað. Allar aðrar samsetningar verða meðhöndlaðar sem ógildar. Sjálfgefin skipun TON frá bindi verður notuð ef TON er stillt á Óþekkt (0). Sjálfgefin skipun NPI frá bindingu verður notuð ef NPI er stillt á Óþekkt (0).
| TONN | NPI | Lýsing |
| Alþjóðlegt (1) | Óþekkt (0) ISDN (1) |
Verður meðhöndlað sem MSISDN |
4.4.2 Stuðlar kóðun
Eftirfarandi kóðun eru studd. X getur innihaldið hvaða gildi sem er.
| DCS | Kóðun |
| 0xX0 | Sjálfgefið GSM stafróf með framlengingu |
| 0xX2 | 8 bita tvöfaldur |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvóti
5.1 Kvóta lokiðview
Kvóti skilgreinir hámarksfjölda SMS-skilaboða sem hægt er að senda innan tiltekins tíma (eins og á dag, viku, mánuði eða ótímabundið). Hver kvóti er einstaklega auðkenndur með kvótaauðkenni (UUID) og er endurstilltur í samræmi við tímabelti viðskiptavinarins. Hægt er að úthluta kvóta á lands-, svæðis- eða sjálfgefnu stigi í gegnum Quote Pro.fileEinnig er hægt að úthluta kvóta á virkan hátt með kvótavörpun. Þetta tengir yfirkvótaauðkenni (UUID) og einstakan kvótalykil (t.d. sendandi eða notandi) við tiltekið kvótaauðkenni.
Kvóti er settur í samræmi við þjónustuver þitt á staðnum, úthlutaðan viðskiptastjóra eða sjálfgefið ef ekkert er tilgreint.
5.2 Staða 106 – Kvóti farið yfir
SMS-skilaboð geta verið lokuð með stöðukóðanum 106 („kvóti farið yfir“) þegar:
- Skilaboðin fara yfir skilgreind mörk fyrir samsvarandi kvótaauðkenni innan núverandi bils.
- Áfangastaðalandið eða svæðið hefur engan kvóta úthlutað (þ.e. er sérstaklega lokað með núllkvótavörpun í pro).file).
- Enginn samsvarandi kvóti er til staðar og enginn sjálfgefinn kvóti er skilgreindur, sem leiðir til höfnunar.
Í þessum tilfellum kemur kerfið í veg fyrir frekari vinnslu skilaboða til að framfylgja takmörkunum sem byggjast á viðskiptavinum eða áfangastöðum og forðast misnotkun.
Afhendingarskýrsla
Aðeins engin eða endanleg afhending með árangursríka/misheppnuðu niðurstöðu er studd.
Snið á afhendingarskýrslu: auðkenni: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx gert dagsetning: yyMMddHHmm staða:
Tiltæk gildi í stöðu:
- DELIVRD
- ÚRUNNIÐ
- HAFNAÐI
- LÍFIÐ
- EYÐIÐ
6.1 Framlengt afhendingarskýrslusnið
Hægt er að biðja um frekari upplýsingar í afhendingarskýrslum í sambandi við sölufulltrúa þinn.
Snið á afhendingarskýrslu: auðkenni: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 dagsetning innsendingar:
ááMMddHHmm Lokadagur: ááMMddHHmm Stat: villu: texti:
Tiltæk gildi í stöðu:
- DELIVRD
- ÚRUNNIÐ
- HAFNAÐI
- LÍFIÐ
- EYÐIÐ
„sub“ og „dlvrd“ reitir verða alltaf stilltir á 000 og „text“ reitir verða alltaf tómir.
Sjá kafla Villukóða fyrir gildi fyrir „villu“ reitinn.
TLS útgáfur studdar
TLS 1.2 eða TLS 1.3 er krafist fyrir allar TLS tengingar yfir SMPP.
Stuðningur við TLS 1.0 og 1.1 er hætt síðan 2020-11-15. Útgáfa 1.0 og 1.1 af TLS eru eldri samskiptareglur sem hafa verið úreltar og eru taldar til öryggisáhættu í netsamfélaginu.
LINK mælir eindregið með því að nota TLS ef ódulkóðaðar SMPP tengingar eru notaðar í dag. Ódulkóðaðar SMPP tengingar eru úreltar frá og með 2020-09-01 af LINK og verða fjarlægðar í framtíðinni. Dagsetning fyrir fjarlægingu ódulkóðaðra tenginga er ekki enn ákveðin.
Tengingar við SMPP miðlara fyrir TLS eru á höfn 3601 í stað þess að vera ódulkóðuð á höfn 3600.
Þú gætir samt notað TLS jafnvel þó að SMPP útfærslan þín styðji ekki TLS með því að nota tunnel, sjá https://www.stunnel.org/
Villukóðar
Eftirfarandi villukóða gæti verið svarað í villureitnum ef reiturinn er virkur.
| Villukóði | Lýsing |
| 0 | Óþekkt villa |
| 1 | Tímabundin leiðarvilla |
| 2 | Varanleg leiðarvilla |
| 3 | Hámarks inngjöf fór yfir |
| 4 | Tímamörk |
| 5 | Óþekkt villa fyrir rekstraraðila |
| 6 | Rekstrarvilla |
| 100 | Þjónustan fannst ekki |
| 101 | Notandi fannst ekki |
| 102 | Reikningur fannst ekki |
| 103 | Ógilt lykilorð |
| 104 | Stillingarvilla |
| 105 | Innri villa |
| 106 | Kvóta farið fram úr |
| 200 | OK |
| 1000 | Sent |
| 1001 | Afhent |
| 1002 | Útrunnið |
| 1003 | Eytt |
| 1004 | Farsíminn fullur |
| 1005 | Í biðröð |
| 1006 | Ekki afhent |
| 1007 | Afhent, gjald seinkað |
| 1008 | Gjaldfært, skilaboð ekki send |
| 1009 | Innheimt, skilaboð ekki afhent |
| 1010 | Útrunnið, fjarvera afhendingarskýrslu rekstraraðila |
| 1011 | Gjaldfært, skilaboð send (til símafyrirtækis) |
| 1012 | Fjarlægð í biðröð |
| 1013 | Skilaboð send til símafyrirtækis, hleðsla seinkað |
| 2000 | Ógilt upprunanúmer |
| 2001 | Stutt númer er ekki stutt sem uppspretta |
| 2002 | Alpha er ekki stutt sem uppspretta |
| 2003 | MSISDN er ekki stutt sem upprunanúmer |
| 2100 | Stutt númer er ekki stutt sem áfangastaður |
| 2101 | Alpha er ekki stutt sem áfangastaður |
| 2102 | MSISDN er ekki stutt sem áfangastaður |
| 2103 | Lokað fyrir aðgerð |
| 2104 | Óþekktur áskrifandi |
| 2105 | Lokað er á áfangastað |
| 2106 | Talnavilla |
| 2107 | Áfangastað lokað tímabundið |
| 2108 | Ógildur áfangastaður |
| 2200 | Hleðsluvilla |
| 2201 | Áskrifandi er með lágt jafnvægi |
|
2202 |
Áskrifanda bannað að greiða of mikið (aukagjald)
skilaboð |
|
2203 |
Áskrifandi of ungur (fyrir þetta tiltekna
innihald) |
| 2204 | Fyrirframgreiddur áskrifandi ekki leyfður |
| 2205 | Þjónustu hafnað af áskrifanda |
| 2206 | Áskrifandi ekki skráður í greiðslukerfi |
| 2207 | Áskrifandi hefur náð hámarksstöðu |
| 2208 | Staðfesting notanda þarf |
| 2300 | Endurgreitt |
|
2301 |
Ekki var hægt að endurgreiða vegna ólöglegs eða týnds efnis
MSISDN |
| 2302 | Gat ekki endurgreitt vegna þess að skilaboðaauðkenni vantaði |
| 2303 | Biðr eftir endurgreiðslu |
| 2304 | Tímamörk endurgreiðslu |
| 2305 | Bilun í endurgreiðslu |
| 3000 | GSM kóðun er ekki studd |
| 3001 | UCS2 kóðun er ekki studd |
| 3002 | Tvöfaldur kóðun er ekki studd |
| 4000 | Afhendingarskýrsla er ekki studd |
| 4001 | Ógilt innihald skilaboða |
| 4002 | Ógild gjaldskrá |
| 4003 | Ógild notendagögn |
| 4004 | Ógildur notendagagnahaus |
| 4005 | Ógild gagnakóðun |
| 4006 | Ógildur vsk |
| 4007 | Óstudd efni fyrir áfangastað |
Skjöl / auðlindir
 |
link mobility SMS API, SMPP API MS Scheduler API [pdfNotendahandbók SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |