Skip to content

SMSBAT API

SMSBAT hija pjattaforma API RESTful biex tibgħat diversi tipi ta 'messaġġi inklużi Viber carousel, Viber opinjoni dialog, Viber promo (stampi, vidjo), Viber negozju chat, notifiki OTP (Viber OTP, Flash Call) u l-varjanti fallback tagħhom.

URL tal-bażi

It-talbiet lil SMSBAT API huma trażmessi lil endpoint b'lokalizzazzjoni. Itlob l-indirizz mill-Maniġer tiegħek minn qabel.

Eżempju: "https://restapi.smsbat.com" (URL attwali jista' jvarja skont ir-reġjun tiegħek)

Awtentikazzjoni

SMSBAT API jappoġġja tliet metodi ta' awtentikazzjoni:

Metodu 1: HTTP Bażiku Awth

Uża l-username u l-kredenzjali tal-password tiegħek:

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

Metodu 2: API Key Header

Uża l-header "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

Metodu 3: Ċavetta API bħala Password

Uża @ bħala username u ċ-ċavetta API tiegħek bħala password:

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

Endpoints Disponibbli

Metodu Endpoint Deskrizzjoni
POST /bat/messagelist Ibgħat messaġġi
IKOLLOK /bat/message/{messageId} Iċċekkja l-istatus tal-messaġġ

Tipi ta' Messaġġi

SMSBAT API jappoġġja t-tipi ta' messaġġi li ġejjin:

  • SMS - Messaġġi standard
  • Viber Promo - Messaġġi promozzjonali b'rich media
  • Viber Transactional - Notifiki tat-tranżazzjonijiet
  • Viber Carousel - Messaġġi interattivi tal-karużell
  • Stħarriġ Viber - Messaġġi ta 'djalogu dwar l-opinjoni
  • Viber OTP - Notifiki ta' password ta' darba
  • RCS - Messaġġi Rich Communication Services
  • Sejħa Flash - Verifika tas-sejħa siekta

Karatteristiċi Ewlenin

Messaġġi ta' Fallback

Meta l-kunsinna primarja tfalli, SMSBAT awtomatikament jaqa' lura għal kanali alternattivi:

Viber → SMS → Email

Rich Media Appoġġ

Ibgħat messaġġi bi:

  • Stampi (JPG, PNG)
  • Vidjows (MP4)
  • PDFs
  • Buttuni u links ta' azzjoni

Traċċar tal-Istatus tal-Messaġġ

Intraċċa l-istatus tal-kunsinna f'ħin reali:

  • Mibgħuta
  • Mogħtija
  • Aqra
  • Falliet
  • Skaduta

Callbacks

Irċievi callbacks ta' messaġġi Viber deħlin għal komunikazzjoni f'żewġ direzzjonijiet.

Quick Start

  1. Ibgħat Messaġġ - Tgħallem kif tibgħat l-ewwel messaġġ tiegħek
  2. Iċċekkja l-Istatus - Issegwi l-istatus tal-kunsinna tal-messaġġ
  3. Tipi ta' messaġġi - Esplora tipi ta' messaġġi differenti

Format tat-Talba

It-talbiet kollha jużaw il-format JSON bl-istruttura li ġejja:

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

Format ta’ Rispons

Risposti b'suċċess jerġgħu lura:

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

Immaniġġjar ta' Żbalji

Kodiċi tal-istatus HTTP:

  • "200 OK" - Talba b'suċċess
  • 400 Talba Ħażina - Format ta' talba mhux validu
  • `401 Mhux awtorizzat' - Awtentikazzjoni falliet
  • "429 Wisq Talbiet" - Inqabeż il-limitu tar-rata
  • "500 Żball Intern tas-Server" - Żball tas-server

Il-passi li jmiss