Skip to content

SMSBAT API

SMSBAT je RESTful API platforma za slanje različitih vrsta poruka uključujući Viber vrtuljak, Viber dijalog mišljenja, Viber promo (slike, video), Viber poslovni chat, OTP obavijesti (Viber OTP, Flash Call) i njihove rezervne varijante.

Osnovni URL

Zahtjevi za SMSBAT API se prenose do krajnje točke s lokalizacijom. Prethodno zatražite adresu od svog menadžera.

Primjer: https://restapi.smsbat.com (stvarni URL može varirati ovisno o vašoj regiji)

Autentifikacija

SMSBAT API podržava tri metode provjere autentičnosti:

Metoda 1: HTTP Basic Auth

Koristite svoje korisničko ime i lozinku akreditive:

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

Metoda 2: Zaglavlje API ključa

Koristite zaglavlje 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

Metod 3: API ključ kao lozinka

Koristite @ kao korisničko ime i svoj API ključ kao lozinku:

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

Dostupne krajnje tačke

Metoda Krajnja tačka Opis
POST /bat/messagelist Pošaljite poruke
GET /bat/message/{messageId} Provjerite status poruke

Vrste poruka

SMSBAT API podržava sljedeće tipove poruka:

  • SMS - Standardne tekstualne poruke
  • Viber Promo - Promotivne poruke sa bogatim medijima
  • Viber Transactional - Obavještenja o transakcijama
  • Viber vrtuljak - Interaktivne ringišpil poruke
  • Viber anketa - Poruke dijaloga mišljenja
  • Viber OTP - Jednokratna obavještenja o lozinki
  • RCS - Poruke bogatih komunikacijskih usluga
  • Flash poziv - Potvrda tihog poziva

Ključne karakteristike

Povratne poruke

Kada primarna isporuka ne uspije, SMSBAT se automatski vraća na alternativne kanale:

Viber → SMS → Email

Podrška za bogate medije

Pošaljite poruke sa:

  • Slike (JPG, PNG)
  • Videos (MP4)
  • PDF-ovi
  • Dugmad i akcioni linkovi

Praćenje statusa poruke

Pratite status isporuke u realnom vremenu:

  • Poslano
  • Isporučeno
  • Čitaj
  • Nije uspjelo
  • Istekao

Povratni pozivi

Primajte povratne pozive dolaznih Viber poruka za dvosmjernu komunikaciju.

Brzi početak

  1. Pošalji poruku - Naučite kako poslati svoju prvu poruku
  2. Provjeri status - Pratite status isporuke poruke
  3. Vrste poruka - Istražite različite vrste poruka

Format zahtjeva

Svi zahtjevi koriste JSON format sa sljedećom strukturom:

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

Format odgovora

Uspješni odgovori vraćaju:

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

Rukovanje greškama

HTTP statusni kodovi:

  • 200 OK - Zahtjev uspješan
  • 400 loših zahtjeva - Nevažeći format zahtjeva
  • 401 Neovlašteno - Autentifikacija nije uspjela
  • 429 Previše zahtjeva - Ograničenje brzine je prekoračeno
  • 500 Interna greška servera - Greška servera

Sljedeći koraci