Pāriet uz saturu

SMSBAT API

SMSBAT ir RESTful API platforma dažāda veida ziņojumu sūtīšanai, ieskaitot Viber karuseli, Viber viedokļu dialogu, Viber reklāmu (attēlus, video), Viber biznesa tērzēšanu, OTP paziņojumus (Viber OTP, Flash Call) un to rezerves variantus.

Pamata URL

Pieprasījumi SMSBAT API tiek pārsūtīti uz galapunktu ar lokalizāciju. Iepriekš pieprasiet adresi savam menedžerim.

Piemērs: https://restapi.smsbat.com (faktiskais URL var atšķirties atkarībā no jūsu reģiona)

Autentifikācija

SMSBAT API atbalsta trīs autentifikācijas metodes:

1. metode: HTTP pamata autentifikācija

Izmantojiet savu lietotājvārdu un paroli:

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

2. metode: API atslēgas galvene

Izmantojiet galveni "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

3. metode: API atslēga kā parole

Izmantojiet @ kā lietotājvārdu un API atslēgu kā paroli:

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

Pieejamie galapunkti

Metode Galapunkts Apraksts
POST /sikspārnis/ziņojumu saraksts Sūtīt ziņas
SAŅEMT /bat/message/{messageId} Pārbaudiet ziņojuma statusu

Ziņojumu veidi

SMSBAT API atbalsta šādus ziņojumu veidus:

  • SMS - standarta īsziņas
  • Viber Promo - reklāmas ziņojumi ar bagātinātu multividi
  • Viber Transactional - Darījumu paziņojumi
  • Viber Carousel - interaktīvi karuseļa ziņojumi
  • Viber Survey - viedokļu dialoga ziņojumi
  • Viber OTP - vienreizēji paziņojumi par paroli
  • RCS — bagātīgi saziņas pakalpojumu ziņojumi
  • Flash Call - klusa zvana pārbaude

Galvenās funkcijas

Atkāpšanās ziņojumapmaiņa

Ja primārā piegāde neizdodas, SMSBAT automātiski atgriežas pie alternatīviem kanāliem:

Viber → SMS → Email

Bagātinātas multivides atbalsts

Sūtīt ziņas ar:

  • attēli (JPG, PNG) - videoklipi (MP4)
  • PDF faili
  • pogas un darbības saites

Ziņojuma statusa izsekošana

Sekojiet piegādes statusam reāllaikā:

  • Nosūtīts
  • Piegādāts
  • Izlasi
  • Neizdevās
  • beidzies derīguma termiņš

Atzvani

Saņemiet ienākošos Viber ziņojumu atzvanus divvirzienu saziņai.

Īsā sākšana

  1. Sūtīt ziņojumu — uzziniet, kā nosūtīt savu pirmo ziņojumu
  2. Pārbaudīt statusu — izsekot ziņojuma piegādes statusu
  3. Ziņojumu veidi — izpētiet dažādus ziņojumu veidus

Pieprasīt formātu

Visos pieprasījumos tiek izmantots JSON formāts ar šādu struktūru:

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

Atbildes formāts

Atgriežas veiksmīgās atbildes:

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

Kļūdu apstrāde

HTTP statusa kodi:

  • 200 OK - Pieprasījums ir veiksmīgs - 400 slikts pieprasījums — nederīgs pieprasījuma formāts
  • 401 Neautorizēts - Autentifikācija neizdevās
  • "429 pārāk daudz pieprasījumu" - pārsniegts likmes ierobežojums
  • "500 Iekšējā servera kļūda" - servera kļūda

Nākamie soļi