Dokumentacija - SMS API

Siųskite ir gaukite SMS pranešimus visame pasaulyje.

Šiame dokumente pateikiamos instrukcijos, kaip integruoti SMS pranešimų siuntimo paslaugas. Mūsų API gali būti naudojamas bet kuris HTTP klientas bet kurioje programavimo kalboje.

SMSBIURAS yra aukštos kokybės SMS platforma, leidžianti integruoti bet kurią savo programą su mūsų SMS žinučių siuntimo ir priėmimo sistema. Pagrindinis mūsų sistemos privalumas yra jos paprastumas. SMS žinutėje gali būti jūsų įmonės pavadinimas arba bet koks Jūsų telefono numeris kaip siuntėjo vardas. Kiekvienas iš mūsų sistemos išsiųstas pranešimas turi savo unikalų ID, kuris leidžia jums gauti patvirtinimą apie jo pristatymą.


Nuo ko pradėti?

Norėdami pradėti naudotis SMSBIURAS teikiamomis paslaugomis, turite susikurti paskyrą SMSBIURAS svetainėje. Registracija yra visiškai nemokama. Jūsų sąskaita bus paruošta nedelsiant po registracijos, registracijos metu pasitvirtinsite savo telefono numerį ir el. pašto adresą. Patvirtintą telefono numerį galėsite naudoti kaip siuntėjo vardą arba galėsite prisidėti Jums reikiamus siuntėjo vardus.


SMS siuntimas GET

Visus SMS pranešimo parametrus galima apibrėžti užklausos eilutėje.


Pagrindinis URL adresas GET

https://savitarna.smsbiuras.lt/api


Užklausos pavyzdys GET

https://savitarna.smsbiuras.lt/api?uid=XX&apikey=XX&message=XX&from=XX&to=XX


Užklausos parametrai

Parametras Aprašymas
uid
Privalomas
 savitarna.smsbiuras.lt kiento kodas.
uid rasite prie api rakto.
apikey
Privalomas
 savitarna.smsbiuras.lt kiento autentifikavimo raktas.
Mano api raktai.
message
Privalomas
 SMS tekstas (tik UTF-8, pvz.: Sveiki pirkėjai!)
from
Privalomas
 Siuntėjo vardas (siuntėjo ID), siuntėjas turi būti patvirtintas prieš SMS siuntimą.
Tikrinti siuntėjo vardus.
to
Privalomas
 Gavėjo telefono numeris (formatas : 3706xxxxxxx)
test Test parametras naudojamas sistemos sujungimo testavimo metu.
Galimos reikšmės: 0 (siunčiama reali SMS), 1 (test SMS, į telefoną nebus pristatoma ir nebus apmokėstinta)
validity Pranešimo galiojimo laikas minutėmis; jam pasibaigus, pranešimo siųsti nebus leidžiama.
Pavyzdys: &validity=720
schedule Atidėto siuntimo formatas: Y-m-d H:m.
Pavyzdys: &scedule=2018-10-11 12:00
flash Šio parametro pagalba galite išsiųsti SMS žinutę kuri automatiškai bus atidaroma gavėjo telefone

Užklausos pavyzdys
Kopijuoti
Atsakymai

Turinio tipas: text/html

Klaidų kodai

Susidūrėte su klaida, klaidų aprašymai padės lengvai nustatyti esamą problemą ir ją išspresti.


Klaidos kodas Klaidos aprašymas
1 Pranešimas buvo apdorotas ir išsiųstas mobiliojo ryšio operatoriui. Bet dar nesugryžę pristatymo patvirtinimai
2 SMS pranešimas nebuvo pristatytas
3 SMS pranešimas buvo sėkmingai pristatytas gavėjui
4 Pranešimas buvo išsiųstas ir jo galiojimo laikas pasibaigė, nes per jo galiojimo laikotarpį (pagal mūsų numatytąją platformą yra 48 valandos) nepavyko pristatyti gavėjui.
5 Pranešimas buvo gautas, bet operatorius grąžino "Atmesta" kaip galutinį statusą.
6 Trūksta parametrų, patikrinkite ar naudojate visus privalomus parametrus.
7 Klaidingas apikey arba uid.
8 Siuntėjo ID - "from". Turi būti patvirtintas administratoriaus.
9 Balansas nepakankamas, prašome papildyti sąskaitą.
10 Blogas "schedule" parametro datos formatas. Pvz.: urlencode("2021-03-11 12:00")