Skoči na vsebino

API SMSBAT

SMSBAT je RESTful API platforma za pošiljanje različnih vrst sporočil, vključno z vrtiljakom Viber, pogovornim oknom za mnenja Viber, promocijo Viber (slike, video), poslovnim klepetom Viber, obvestili OTP (Viber OTP, Flash Call) in njihovimi nadomestnimi različicami.

Osnovni URL

Zahteve za SMSBAT API se prenesejo na končno točko z lokalizacijo. Predhodno zahtevajte naslov pri svojem upravitelju.

Primer: https://restapi.smsbat.com (dejanski URL se lahko razlikuje glede na vašo regijo)

Preverjanje pristnosti

SMSBAT API podpira tri metode preverjanja pristnosti:

1. način: HTTP Basic Auth

Uporabite svoje uporabniško ime in geslo:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

2. način: Glava ključa API

Uporabite glavo X-Authorization-Key:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

3. način: API ključ kot geslo

Uporabite @ kot uporabniško ime in svoj API ključ kot geslo:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Razpoložljive končne točke

Metoda Končna točka Opis
OBJAVI /bat/messagelist Pošlji sporočila
PRIDOBITE /bat/message/{messageId} Preverite status sporočila

Vrste sporočil

SMSBAT API podpira naslednje vrste sporočil:

  • SMS - Standardna besedilna sporočila
  • Viber Promo - Promocijska sporočila z obogateno predstavnostjo
  • Viber Transactional - Obvestila o transakcijah
  • Viber Carousel - Interaktivna sporočila vrtiljaka
  • Viber Anketa - Pogovorna sporočila mnenj
  • Viber OTP - Obvestila o enkratnem geslu
  • RCS - sporočila obogatenih komunikacijskih storitev
  • Flash Call - Tiho preverjanje klica

Ključne lastnosti

Nadomestno sporočanje

Ko primarna dostava ne uspe, se SMSBAT samodejno vrne na alternativne kanale:

Viber → SMS → Email

Podpora za bogato predstavnost

Pošiljanje sporočil z:

  • Slike (JPG, PNG)
  • Video posnetki (MP4)
  • PDF datoteke
  • Gumbi in povezave do dejanj

Sledenje statusu sporočila

Spremljajte stanje dostave v realnem času:

  • Poslano
  • Dostavljeno
  • Preberi
  • Ni uspelo
  • potekel

Povratni klici

Prejmite povratne klice dohodnih sporočil Viber za dvosmerno komunikacijo.

Hitri začetek

  1. Pošlji sporočilo - Naučite se poslati svoje prvo sporočilo
  2. Preveri status - Sledite statusu dostave sporočila
  3. Vrste sporočil - Raziščite različne vrste sporočil

Oblika zahteve

Vse zahteve uporabljajo format JSON z naslednjo strukturo:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

Oblika odgovora

Uspešni odgovori vrnejo:

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

Obravnava napak

Statusne kode HTTP:

  • 200 OK - Zahteva uspešna
  • 400 Bad Request - Neveljavna oblika zahteve
  • 401 Nepooblaščeno - Preverjanje pristnosti ni uspelo
  • 429 Too Many Requests - Omejitev stopnje je presežena
  • 500 Internal Server Error - Napaka strežnika

Naslednji koraki