SMS API,SMPP API MS Scheduler API
Uputstvo za upotrebu
SMS API,SMPP API MS Scheduler API
| Izmijenjeno: | 6/24/2025 |
| verzija: | 1.7 |
| Autor: | Kenny Colander Norden, KCN |
Ovaj dokument je samo za određenog primaoca i može sadržavati privilegovane, vlasničke ili druge privatne informacije. Ako ste ga primili greškom, odmah obavijestite pošiljaoca i izbrišite original. Zabranjena je svaka druga upotreba dokumenta.
Historija promjena
| Rev | Datum | By | Promjene u odnosu na prethodno izdanje |
| 1.0 | 2010-03-16 | KCN | Created |
| 1. | 2019-06-11 | TPE | Ažurirani LINK logotipi |
| 1. | 2019-09-27 | PNI | Dodata referenca na SMPP 3.4 specifikaciju |
| 1. | 2019-10-31 | EP | Zapažanje o roku važenja tag |
| 1. | 2020-08-28 | KCN | Dodane informacije o podržanim verzijama TLS-a |
| 2. | 2022-01-10 | KCN | Dodane dodatne informacije u vezi sa izvještajima o isporuci Ažurirane informacije u vezi sa TLS 1.3 |
| 2. | 2025-06-03 | GM | Dodan je kod rezultata 2108 |
| 2. | 2025-06-24 | AK | Dodana kvota |
Uvod
LINK Mobility je distributer SMS-a od 2001. godine i ima mnogo iskustva u radu kako sa operaterima tako i sa agregatorima veza. Ova platforma je dizajnirana da obrađuje velike količine prometa, održava visoku dostupnost i olakšava usmjeravanje saobraćaja putem više veza.
Ovaj dokument opisuje SMPP interfejs za SMSC platformu i koji su parametri i komande 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 komande
LINK Mobility server treba tretirati kao SMPP 3.4. Zvanična specifikacija se može naći na https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Sve metode nisu podržane, a sve razlike su navedene u nastavku.
4.1 Vezivanje
Podržane su sljedeće komande za povezivanje.
- Predajnik
- Transciever
- Prijemnik
Potrebni parametri:
- system_id – dobijeno od podrške
- lozinka – dobijena od podrške
Opcioni parametri:
- addr_ton – zadana vrijednost ako je TON postavljen na Nepoznato tokom slanja.
- addr_npi – zadana vrijednost ako je NPI postavljen na Nepoznato tokom slanja.
Nepodržani parametri:
- opseg_adrese
4.2 Odvezivanje
Naredba unbind je podržana.
4.3 Veza za upit
Komanda upita za vezu je podržana i treba je pozivati svakih 60 sekundi.
4.4 Podnesite
Za isporuku poruka treba koristiti metod slanja.
Potrebni parametri:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- kratka_poruka
Nepodržani parametri:
- service_type
- protocol_id
- priority_flag
- raspored_vrijeme_isporuke
- replace_if_present_flag
- sm_default_msg_id
Napomena da nosivost tag nije podržano i samo jedan SMS može biti isporučen po pozivu i preporučuje se da validity_period tag ima vrijednost od najmanje 15 minuta.
4.4.1 Preporučeni TON i NPI
Sljedeće TON i NPI treba koristiti prilikom slanja poruka korištenjem naredbe za slanje.
4.4.1.1 Izvor
Sljedeće kombinacije TON i NPI su podržane za izvornu adresu. Sve ostale kombinacije će se tretirati kao nevažeće. Zadana naredba TON from bind će se koristiti ako je TON postavljen na Nepoznato (0). Zadana naredba NPI from bind će se koristiti ako je NPI postavljen na Nepoznato (0).
| TON | NPI | Opis |
| Alfanumerički (5) | Nepoznato (0) ISDN (1) |
Tretiraće se kao alfanumerički tekst pošiljaoca |
| međunarodni (1) | Nepoznato (0) ISDN (1) |
Tretiraće se kao MSISDN |
| nacionalni (2) Specifično za mrežu (3) Broj pretplatnika (4) Skraćeno (6) |
Nepoznato (0) ISDN (1) nacionalni (8) |
Tretiraće se kao kratki broj za određenu zemlju. |
4.4.1.2 Odredište
Sljedeće kombinacije TON i NPI su podržane za odredišnu adresu. Sve ostale kombinacije će se tretirati kao nevažeće. Zadana naredba TON from bind će se koristiti ako je TON postavljen na Nepoznato (0). Zadana naredba NPI from bind će se koristiti ako je NPI postavljen na Nepoznato (0).
| TON | NPI | Opis |
| međunarodni (1) | Nepoznato (0) ISDN (1) |
Tretirać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 sa ekstenzijom |
| 0xX2 | 8-bitni binarni |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Kvota prekoračenaview
Kvota definira maksimalan broj SMS poruka koje se mogu poslati u određenom vremenskom intervalu (npr. po danu, sedmici, mjesecu ili neograničeno). Svaka kvota je jedinstveno identificirana pomoću quotaId-a (UUID) i resetuje se prema vremenskoj zoni korisnika. Kvote se mogu dodijeliti na nivou zemlje, regije ili zadanog nivoa putem Quota Pro-a.fileKvota se također može dinamički dodijeliti pomoću mapiranja kvota. Ovo mapira roditeljski 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 menadžerom 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 ovim slučajevima, sistem sprečava daljnju obradu poruka kako bi se sprovela ograničenja zasnovana na kupcu ili odredištu i izbjegla zloupotreba.
Izvještaj o isporuci
Podržana je samo nikakva ili konačna isporuka s uspješnim/neuspjelim rezultatom.
Format izvještaja o isporuci: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx datum izvršenja: yyMMddHHmm stat:
Dostupne vrijednosti u statusu:
- DELIVRD
- ISTEKLO
- REJECTD
- UNDELIV
- IZBRISAN
6.1 Prošireni format izvještaja o isporuci
Proširene informacije u izvještajima o isporuci možete zatražiti u kontaktu sa vašim prodajnim predstavnikom.
Format izvještaja o isporuci: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 datum slanja:
ggMMddHHmm datum završetka: ggMMddHHmm stat: greška: tekst:
Dostupne vrijednosti u statusu:
- DELIVRD
- ISTEKLO
- REJECTD
- UNDELIV
- IZBRISAN
Polja “sub” i “dlvrd” će uvijek 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 je potreban za sve TLS veze preko SMPP-a.
Podrška za TLS 1.0 i 1.1 je ukinuta od 2020-11-15. Verzije 1.0 i 1.1 TLS-a su stariji protokoli koji su zastarjeli i smatraju se sigurnosnim rizicima u Internet zajednici.
LINK toplo preporučuje korištenje TLS-a ako se danas koriste nešifrirane SMPP veze. Nešifrovane SMPP veze su zastarjele od 2020-09-01 od strane LINK-a i bit će uklonjene u budućnosti. Datum uklanjanja nešifriranih veza još nije određen.
Veze prema SMPP serveru za TLS su na portu 3601 umjesto nešifrovane na portu 3600.
I dalje 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će šifre grešaka se mogu odgovoriti u polju err ako je polje omogućeno.
| Kôd greške | Opis |
| 0 | Nepoznata greška |
| 1 | Privremena greška rutiranja |
| 2 | Trajna greška rutiranja |
| 3 | Maksimalno prigušivanje je premašeno |
| 4 | Timeout |
| 5 | Operator nepoznata greška |
| 6 | Greška operatera |
| 100 | Usluga nije pronađena |
| 101 | Korisnik nije pronađen |
| 102 | Račun nije pronađen |
| 103 | Nevažeća lozinka |
| 104 | Greška u konfiguraciji |
| 105 | Interna greška |
| 106 | Kvota je prekoračena |
| 200 | OK |
| 1000 | Poslano |
| 1001 | Isporučeno |
| 1002 | Istekao |
| 1003 | Izbrisano |
| 1004 | Mobilni pun |
| 1005 | U redu |
| 1006 | Nije isporučeno |
| 1007 | Isporučeno, naplata kasni |
| 1008 | Naplaćeno, poruka nije poslata |
| 1009 | Naplaćeno, poruka nije isporučena |
| 1010 | Istekao, izostanak izvještaja o dostavi operatera |
| 1011 | Naplaćeno, poruka poslata (operateru) |
| 1012 | Daljinski u redu |
| 1013 | Poruka poslata operateru, naplata kasni |
| 2000 | Nevažeći izvorni broj |
| 2001 | Kratki broj nije podržan kao izvor |
| 2002 | Alpha nije podržan 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 je 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 balans |
|
2202 |
Pretplatnik je blokiran zbog prekomjerne naplate (premium)
poruke |
|
2203 |
Pretplatnik je premlad (za ovo konkretno
sadržaj) |
| 2204 | Prepaid pretplatnik nije dozvoljen |
| 2205 | Pretplatnik je odbio uslugu |
| 2206 | Pretplatnik nije registrovan u platnom sistemu |
| 2207 | Pretplatnik je dostigao maksimalan balans |
| 2208 | Potrebna potvrda krajnjeg korisnika |
| 2300 | Refundirano |
|
2301 |
Povrat novca nije moguć zbog ilegalnog ili nedostajućeg
MSISDN |
| 2302 | Nije moguće vratiti novac jer nedostaje ID poruke |
| 2303 | U redu za povrat novca |
| 2304 | Vremensko ograničenje povrata novca |
| 2305 | Neuspjeh povrata novca |
| 3000 | GSM kodiranje nije podržano |
| 3001 | UCS2 kodiranje nije podržano |
| 3002 | Binarno kodiranje nije podržano |
| 4000 | Izvještaj o isporuci nije podržan |
| 4001 | Nevažeći sadržaj poruke |
| 4002 | Nevažeća 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
 |
link mobilnost SMS API,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 |