Kalo te përmbajtja

SMSBAT API

SMSBAT është një platformë API RESTful për dërgimin e llojeve të ndryshme të mesazheve, duke përfshirë Viber carousel, Viber opinion opinion, Viber promo (fotografi, video), Viber chat biznesi, njoftime OTP (Viber OTP, Flash Call) dhe variantet e tyre rezervë.

URL bazë

Kërkesat për SMSBAT API transmetohen në një pikë fundore me lokalizim. Kërkoni adresën nga menaxheri juaj paraprakisht.

Shembull: https://restapi.smsbat.com (URL-ja aktuale mund të ndryshojë në varësi të rajonit tuaj)

Autentifikimi

SMSBAT API mbështet tre metoda të vërtetimit:

Metoda 1: Authimi bazë HTTP

Përdorni kredencialet e emrit tuaj të përdoruesit dhe fjalëkalimit:

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

Metoda 2: Kreu i çelësit të API

Përdorni kokën "X-Authorization-Key":

KODI_BLOCK_1

Metoda 3: Çelësi API si fjalëkalim

Përdorni @ si emër përdoruesi dhe çelësin tuaj API si fjalëkalim:

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

Pikat përfundimtare të disponueshme

Metoda Pika fundore Përshkrimi
POST /bat/messagelist Dërgo mesazhe
MERRNI /bat/message/{messageId} Kontrolloni statusin e mesazhit

Llojet e mesazheve

SMSBAT API mbështet llojet e mëposhtme të mesazheve:

  • SMS - Mesazhe standarde me tekst
  • Viber Promo - Mesazhe promocionale me media të pasura
  • Viber Transactional - Njoftimet e transaksioneve
  • Viber Carousel - Mesazhe interaktive karuseli
  • Viber Survey - Mesazhet e dialogut të opinionit
  • Viber OTP - Njoftimet me fjalëkalim një herë
  • RCS - Mesazhe të pasura të shërbimeve të komunikimit
  • Flash Call - Verifikimi i heshtur i thirrjes

Karakteristikat kryesore

Mesazhe kthimi

Kur dorëzimi parësor dështon, SMSBAT automatikisht kthehet në kanale alternative:

KODI_BLOCK_3

Mbështetje për media të pasura

Dërgoni mesazhe me:

  • Imazhe (JPG, PNG)
  • Video (MP4)
  • PDF
  • Butonat dhe lidhjet e veprimit

Ndjekja e statusit të mesazhit

Gjurmo statusin e dorëzimit në kohë reale:

  • Dërguar
  • Dorëzuar
  • Lexo
  • Dështoi
  • Ka skaduar

Thirrjet

Merr kthime të mesazheve në Viber për komunikim të dyanshëm.

Fillimi i shpejtë

  1. Send a Message - Mësoni se si të dërgoni mesazhin tuaj të parë
  2. Kontrollo statusin - Gjurmo statusin e dorëzimit të mesazhit
  3. Llojet e mesazheve - Eksploroni lloje të ndryshme mesazhesh

Formati i kërkesës

Të gjitha kërkesat përdorin formatin JSON me strukturën e mëposhtme:

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

Formati i përgjigjes

Përgjigjet e suksesshme kthehen:

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

Trajtimi i gabimeve

Kodet e statusit HTTP:

  • 200 OK - Kërkesa me sukses
  • 400 Kërkesë e keqe - Format i pavlefshëm i kërkesës
  • 401 Unauthorized - Authentication failed
  • 429 shumë kërkesa - Kufiri i tarifës u tejkalua
  • 500 Gabim i brendshëm i serverit - Gabim serveri

Hapat e ardhshëm