SMS API, SMPP API MS Scheduler API
Upute za korištenje
SMS API, SMPP API MS Scheduler API
| Izmijenjeno: | 6 |
| Verzija: | 1.7 |
| Autor: | Kenny Colander Norden, KCN |
Ovaj je dokument samo za naznačenog primatelja i može sadržavati povlaštene, vlasničke ili druge privatne informacije. Ako ste ga primili pogreškom, odmah obavijestite pošiljatelja i izbrišite izvornik. Zabranjena je svaka druga upotreba dokumenta s vaše strane.
Povijest promjena
| vlč | Datum | By | Promjene u odnosu na prethodno izdanje |
| 1.0 | 2010-03-16 | KCN | Stvoreno |
| 1. | 2019-06-11 | TPE | Ažurirani LINK logotipi |
| 1. | 2019-09-27 | PNI | Dodana referenca na specifikaciju SMPP 3.4 |
| 1. | 2019-10-31 | EP | Zapažanje o roku valjanosti tag |
| 1. | 2020-08-28 | KCN | Dodane informacije o podržanim TLS verzijama |
| 2. | 2022-01-10 | KCN | Dodane dodatne informacije o izvješćima o isporuci Ažurirane informacije o TLS-u 1.3 |
| 2. | 2025-06-03 | GM | Dodan je rezultatni kod 2108 |
| 2. | 2025-06-24 | AK | Dodana kvota |
Uvod
LINK Mobility je SMS distributer od 2001. godine i ima veliko iskustvo u radu kako s operaterima tako i s agregatorima veza. Ova je platforma dizajnirana za rukovanje velikim količinama prometa, održavanje visoke dostupnosti i olakšavanje usmjeravanja prometa putem višestrukih veza.
Ovaj dokument opisuje SMPP sučelje za SMSC platformu te koji su parametri i naredbe potrebni i koji su parametri podržani.
Ovaj dokument neće obrađivati specifične slučajeve upotrebe kao što su spojene poruke, WAPpush, Flash SMS itd. Više informacija o tim slučajevima možete dobiti kontaktiranjem podrške.
Podržane naredbe
LINK Mobility poslužitelj treba tretirati kao SMPP 3.4. Službena specifikacija može se pronaći na https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Sve metode nisu podržane, a sve su razlike navedene u nastavku.
4.1 Vezati
Podržane su sljedeće naredbe vezanja.
- Odašiljač
- primopredajnik
- Prijemnik
Potrebni parametri:
- system_id – dobiven od podrške
- lozinka – dobivena od podrške
Neobavezni parametri:
- addr_ton – zadana vrijednost ako je TON postavljen na Nepoznato tijekom slanja.
- addr_npi – zadana vrijednost ako je NPI postavljen na Nepoznato tijekom slanja.
Nepodržani parametri:
- raspon_adresa
4.2 Odvezati
Naredba unbind je podržana.
4.3 Veza za upit
Naredba inquire link je podržana i treba je pozvati svakih 60 sekundi.
4.4 Pošaljite
Za isporuku poruka treba koristiti metodu slanja.
Potrebni parametri:
- izvor_addr_ton
- izvor_addr_npi
- izvorna_adresa
- odredišna_adresa_ton
- dest_addr_npi
- odredišna_adresa
- esm_klasa
- kodiranje podataka
- sm_duljina
- kratka poruka
Nepodržani parametri:
- vrsta_usluge
- protokol_id
- zastavica_prioriteta
- raspored_vrijeme_isporuke
- zamijeni_ako_je_prisutna_zastavica
- sm_default_msg_id
Bilješka da je nosivost tag nije podržano i može se isporučiti samo jedan SMS po pozivu te se preporučuje da validity_period tag ima vrijednost od najmanje 15 minuta.
4.4.1 Preporučeni TON i NPI
Sljedeći TON i NPI trebali bi se koristiti prilikom slanja poruka pomoću naredbe za slanje.
4.4.1.1 Izvor
Sljedeće kombinacije TON i NPI podržane su za izvornu adresu. Sve ostale kombinacije bit će tretirane kao nevažeće. Zadana naredba TON from bind koristit će se ako je TON postavljen na Nepoznato (0). Zadana naredba NPI from bind koristit će se ako je NPI postavljen na Nepoznato (0).
| TONA | NPI | Opis |
| Alfanumerički (5) | Nepoznato (0) ISDN (1) |
Tretirat će se kao alfanumerički tekst pošiljatelja |
| međunarodni (1) | Nepoznato (0) ISDN (1) |
Tretirat će se kao MSISDN |
| nacionalni (2) Specifično za mrežu (3) Broj pretplatnika (4) Skraćeno (6) |
Nepoznato (0) ISDN (1) nacionalni (8) |
Tretirat će se kao kratki broj specifičan za državu. |
4.4.1.2 Odredište
Za odredišnu adresu podržane su sljedeće kombinacije TON i NPI. Sve ostale kombinacije smatrat će se nevažećima. Zadana naredba TON iz povezivanja koristit će se ako je TON postavljen na Nepoznato (0). Zadani NPI iz naredbe vezanja koristit će se ako je NPI postavljen na Nepoznato (0).
| TONA | NPI | Opis |
| međunarodni (1) | Nepoznato (0) ISDN (1) |
Tretirat će se kao MSISDN |
4.4.2 Podržana kodiranja
Podržana su sljedeća kodiranja. X može sadržavati bilo koju vrijednost.
| DCS | Kodiranje |
| 0xX0 | Zadana GSM abeceda s proširenjem |
| 0xX2 | 8-bitni binarni |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Kvota prekoračenaview
Kvota definira maksimalni broj SMS poruka koje se mogu poslati unutar određenog vremenskog intervala (npr. po danu, tjednu, mjesecu ili neograničeno). Svaka kvota je jedinstveno identificirana quotaId-om (UUID) i resetira se prema vremenskoj zoni korisnika. Kvote se mogu dodijeliti na razini zemlje, regije ili zadane razine putem Quota Pro-a.fileKvota se također može dinamički dodijeliti pomoću mapiranja kvota. Ovo mapira nadređeni QuotaId (UUID) i jedinstveni ključ kvote (npr. pošiljatelj ili korisnik) na određeni quotaId.
Kvota se postavlja u skladu s vašom lokalnom podrškom, vašim dodijeljenim upraviteljem računa ili prema zadanim postavkama ako ništa nije navedeno.
5.2 Status 106 – Kvota prekoračena
SMS poruka može biti blokirana sa statusnim kodom 106 („kvota prekoračena“) kada:
- Poruka premašuje definirano ograničenje za odgovarajući quotaId unutar trenutnog intervala.
- Odredišna zemlja ili regija nema dodijeljenu kvotu (tj. eksplicitno je blokirana mapiranjem null kvote u profile).
- Ne postoji odgovarajuća kvota i nije definirana zadana kvota, što rezultira odbijanjem.
U tim slučajevima sustav sprječava daljnju obradu poruka kako bi se provela ograničenja temeljena na kupcu ili odredištu i izbjegla zlouporaba.
Izvješće o isporuci
Podržana je samo nikakva ili konačna isporuka s uspješnim/neuspješnim rezultatom.
Format izvješća o isporuci: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx datum izvršenja: yyMMddHHmm stat:
Dostupne vrijednosti u statusu:
- DELIVRD
- ISTEKAO
- ODBIJENO
- NEODELIV
- OBRISAN
6.1 Format proširenog izvješća o isporuci
Proširene informacije u izvješćima o isporuci mogu se zatražiti u kontaktu s vašim prodajnim predstavnikom.
Format izvješća o isporuci: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 datum slanja:
ggMMddHHmm datum završetka: ggMMddHHmm stat: griješi: tekst:
Dostupne vrijednosti u statusu:
- DELIVRD
- ISTEKAO
- ODBIJENO
- NEODELIV
- OBRISAN
Polja “sub” i “dlvrd” uvijek će biti postavljena na 000, a polje “text” će uvijek biti prazno.
Pogledajte poglavlje Kodovi grešaka za vrijednosti za polje “err”.
Podržane TLS verzije
TLS 1.2 ili TLS 1.3 potreban je za sve TLS veze preko SMPP-a.
Podrška za TLS 1.0 i 1.1 ukinuta je od 2020. listopada 11. Verzije 15 i 1.0 TLS-a su stariji protokoli koji su zastarjeli i smatraju se sigurnosnim rizicima u internetskoj zajednici.
LINK toplo preporučuje korištenje TLS-a ako se danas koriste nešifrirane SMPP veze. Nešifrirane SMPP veze zastarjele su od 2020. rujna 09. putem LINK-a i bit će uklonjene u budućnosti. Datum uklanjanja nešifriranih veza još nije određen.
Veze prema SMPP poslužitelju za TLS su na portu 3601 umjesto nešifrirane na portu 3600.
Još uvijek možete koristiti TLS čak i ako vaša SMPP implementacija ne podržava TLS koristeći stunnel, pogledajte https://www.stunnel.org/
Kodovi grešaka
Sljedeći kodovi grešaka mogu se prikazati u polju err ako je polje omogućeno.
| Šifra greške | Opis |
| 0 | Nepoznata pogreška |
| 1 | Privremena pogreška usmjeravanja |
| 2 | Trajna pogreška usmjeravanja |
| 3 | Prekoračeno je maksimalno prigušivanje |
| 4 | Istek vremena |
| 5 | Nepoznata pogreška operatera |
| 6 | Greška operatera |
| 100 | Usluga nije pronađena |
| 101 | Korisnik nije pronađen |
| 102 | račun nije pronađen |
| 103 | Netočna zaporka |
| 104 | Greška u konfiguraciji |
| 105 | Interna greška |
| 106 | Kvota prekoračena |
| 200 | OK |
| 1000 | Poslano |
| 1001 | Isporučeno |
| 1002 | Istekao |
| 1003 | Izbrisano |
| 1004 | Mobitel pun |
| 1005 | U redu čekanja |
| 1006 | Nije isporučeno |
| 1007 | Isporučeno, naplata odgođena |
| 1008 | Naplaćeno, poruka nije poslana |
| 1009 | Naplaćeno, poruka nije isporučena |
| 1010 | Isteklo, nepostojanje izvješća o dostavi operatera |
| 1011 | Naplaćeno, poruka poslana (operateru) |
| 1012 | Udaljeno u redu čekanja |
| 1013 | Poruka poslana operateru, naplata odgođena |
| 2000 | Nevažeći broj izvora |
| 2001 | Kratki broj nije podržan kao izvor |
| 2002 | Alfa nije podržana kao izvor |
| 2003 | MSISDN nije podržan kao izvorni broj |
| 2100 | Kratki broj nije podržan kao odredište |
| 2101 | Alpha nije podržana kao odredište |
| 2102 | MSISDN nije podržan kao odredište |
| 2103 | Operacija blokirana |
| 2104 | Nepoznati pretplatnik |
| 2105 | Odredište blokirano |
| 2106 | Greška u broju |
| 2107 | Odredište je privremeno blokirano |
| 2108 | Nevažeće odredište |
| 2200 | Greška pri punjenju |
| 2201 | Pretplatnik ima nizak saldo |
|
2202 |
Pretplatnik blokiran zbog prekomjerne naplate (premium)
poruke |
|
2203 |
Pretplatnik je premlad (za ovo konkretno
sadržaj) |
| 2204 | Prepaid pretplatnik nije dopušten |
| 2205 | Pretplatnik je odbio uslugu |
| 2206 | Pretplatnik nije registriran u sustavu plaćanja |
| 2207 | Pretplatnik je dosegao maksimalan saldo |
| 2208 | Potrebna je potvrda krajnjeg korisnika |
| 2300 | Vraćeno |
|
2301 |
Povrat nije moguć zbog nezakonitog ili nedostajućeg
MSISDN |
| 2302 | Povrat novca nije moguć jer nedostaje ID poruke |
| 2303 | U redu za povrat novca |
| 2304 | Istek povrata |
| 2305 | Povrat nije uspio |
| 3000 | GSM kodiranje nije podržano |
| 3001 | UCS2 kodiranje nije podržano |
| 3002 | Binarno kodiranje nije podržano |
| 4000 | Izvješće o isporuci nije podržano |
| 4001 | Nevažeći sadržaj poruke |
| 4002 | Neispravna tarifa |
| 4003 | Nevažeći korisnički podaci |
| 4004 | Nevažeće zaglavlje korisničkih podataka |
| 4005 | Nevažeće kodiranje podataka |
| 4006 | Nevažeći PDV |
| 4007 | Nepodržani sadržaj za odredište |
Dokumenti / Resursi
 |
SMS API za mobilnost veze, SMPP API MS Scheduler API [pdf] Korisnički priručnik SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |