Preskoči na sadržaj

SMSBAT API

SMSBAT je RESTful API platforma za slanje raznih vrsta poruka uključujući Viber karusel, 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 prenose se krajnjoj točki s lokalizacijom. Prethodno zatražite adresu od svog upravitelja.

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

Autentifikacija

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

Metoda 1: Osnovna HTTP autentifikacija

Upotrijebite vjerodajnice za korisničko ime i lozinku:

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

Metoda 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 točke

Metoda Krajnja točka Opis
OBJAVI /bat/messagelist Slanje poruka
DOBITI /bat/message/{messageId} Provjerite status poruke

Vrste poruka

SMSBAT API podržava sljedeće vrste poruka:

  • SMS - Standardne tekstualne poruke
  • Viber Promo - Promotivne poruke s bogatim medijima
  • Viber Transactional - Obavijesti o transakcijama
  • Viber Carousel - Interaktivni karusel poruka
  • Viber Anketa - Dijaloške poruke mišljenja
  • Viber OTP - Obavijesti o jednokratnim lozinkama
  • RCS - Rich Communication Services poruke
  • Flash Call - Tiha provjera poziva

Ključne značajke

Rezervne 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 pomoću:

  • Slike (JPG, PNG)
  • Video zapisi (MP4)
  • PDF datoteke
  • Gumbi i akcijske veze

Praćenje statusa poruke

Pratite status isporuke u stvarnom vremenu:

  • Poslano
  • Isporučeno
  • Čitaj
  • Neuspješno
  • isteklo

Povratni pozivi

Primajte povratne dolazne Viber poruke 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 se:

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

Rješavanje grešaka

HTTP statusni kodovi:

  • 200 OK - Zahtjev uspješan
  • 400 Bad Request - Nevažeći format zahtjeva
  • 401 Unauthorized - Autentifikacija nije uspjela
  • 429 Previše zahtjeva - Ograničenje brzine premašeno
  • 500 Internal Server Error - Greška poslužitelja

Sljedeći koraci