Skip to content

SMSBAT API

SMSBAT este o platformă API RESTful pentru trimiterea diferitelor tipuri de mesaje, inclusiv carusel Viber, dialog de părere Viber, promoție Viber (imagini, video), chat de afaceri Viber, notificări OTP (Viber OTP, apel flash) și variantele lor de rezervă.

URL de bază

Solicitările către SMSBAT API sunt transmise la un punct final cu localizare. Solicitați adresa managerului dumneavoastră în prealabil.

Exemplu: „https://restapi.smsbat.com” (adresa URL reală poate varia în funcție de regiunea dvs.)

Autentificare

API-ul SMSBAT acceptă trei metode de autentificare:

Metoda 1: HTTP Basic Auth

Utilizați acreditările dvs. de utilizator și parolă:

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

Metoda 2: Antetul cheii API

Utilizați antetul „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: Cheia API ca parolă

Folosiți @ ca nume de utilizator și cheia dvs. API ca parolă:

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

Puncte finale disponibile

Metoda Punct final Descriere
POST /bat/messagelist Trimite mesaje
GET /bat/message/{messageId} Verificați starea mesajului

Tipuri de mesaje

API-ul SMSBAT acceptă următoarele tipuri de mesaje:

  • SMS - Mesaje text standard
  • Viber Promo - Mesaje promoționale cu rich media
  • Viber Transactional - Notificări privind tranzacțiile
  • Viber Carusel - Mesaje interactive din carusel
  • Sondaj Viber - Mesaje de dialog cu opinii
  • Viber OTP - Notificări unice privind parola
  • RCS - Mesaje Rich Communication Services
  • Apel flash - Verificare silențioasă a apelului

Caracteristici cheie

Mesaje de rezervă

Când livrarea primară eșuează, SMSBAT revine automat la canalele alternative:

Viber → SMS → Email

Suport media îmbogățit

Trimite mesaje cu:

  • Imagini (JPG, PNG)
  • Videoclipuri (MP4)
  • PDF-uri
  • Butoane și link-uri de acțiune

Urmărirea stării mesajelor

Urmăriți starea livrării în timp real:

  • Trimis
  • Livrat
  • Citește
  • A eşuat
  • A expirat

Reapeluri

Primiți apeluri de mesaje Viber primite pentru comunicare bidirecțională.

Pornire rapidă

  1. Trimite un mesaj - Află cum să trimiți primul tău mesaj
  2. Verificați starea - Urmăriți starea livrării mesajelor
  3. Tipuri de mesaje - Explorați diferite tipuri de mesaje

Format de solicitare

Toate cererile folosesc formatul JSON cu următoarea structură:

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

Format de răspuns

Răspunsurile de succes revin:

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

Gestionarea erorilor

Codurile de stare HTTP:

  • 200 OK - Solicitare reușită
  • 400 Solicitare greșită - Format de solicitare nevalid
  • 401 Neautorizat - Autentificarea eșuată
  • 429 Too Many Requests - Limita ratei a fost depășită
  • 500 Internal Server Error - Eroare de server

Următorii pași