I-skip tungo sa nilalaman

SMSBAT API

Ang SMSBAT ay isang RESTful API platform para sa pagpapadala ng iba't ibang uri ng mga mensahe kabilang ang Viber carousel, Viber opinion dialog, Viber promo (mga larawan, video), Viber business chat, OTP notification (Viber OTP, Flash Call) at ang kanilang mga fallback na variant.

Base URL

Ang mga kahilingan sa SMSBAT API ay ipinapadala sa isang endpoint na may lokalisasyon. Humiling ng address mula sa iyong Manager nang maaga.

Halimbawa: https://restapi.smsbat.com (maaaring mag-iba ang aktwal na URL batay sa iyong rehiyon)

Pagpapatotoo

Sinusuportahan ng SMSBAT API ang tatlong paraan ng pagpapatunay:

Paraan 1: HTTP Basic Auth

Gamitin ang iyong mga kredensyal ng username at password:

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

Paraan 2: API Key Header

Gamitin ang header ng 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

Paraan 3: API Key bilang Password

Gamitin ang @ bilang username at ang iyong API key bilang password:

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

Magagamit na Mga Endpoint

Paraan Endpoint Paglalarawan
POST /bat/messagelist Magpadala ng mga mensahe
KUMUHA /bat/message/{messageId} Suriin ang katayuan ng mensahe

Mga Uri ng Mensahe

Sinusuportahan ng SMSBAT API ang mga sumusunod na uri ng mensahe:

  • SMS - Mga karaniwang text message
  • Viber Promo - Mga mensaheng pang-promosyon sa rich media
  • Viber Transactional - Mga notification sa Transaksyon
  • Viber Carousel - Mga interactive na mensahe ng carousel
  • Viber Survey - Mga mensahe ng dialog ng opinyon
  • Viber OTP - Isang beses na mga notification ng password
  • RCS - Mga mensahe ng Rich Communication Services
  • Flash Call - Silent call verification

Mga Pangunahing Tampok

Fallback Messaging

Kapag nabigo ang pangunahing paghahatid, awtomatikong bumabalik ang SMSBAT sa mga alternatibong channel:

Viber → SMS → Email

Suporta sa Rich Media

Magpadala ng mga mensahe gamit ang:

  • Mga Larawan (JPG, PNG)
  • Mga Video (MP4)
  • Mga PDF
  • Mga pindutan at link ng pagkilos

Pagsubaybay sa Katayuan ng Mensahe

Subaybayan ang katayuan ng paghahatid sa real-time:

  • Ipinadala
  • Naihatid
  • Basahin
  • Nabigo
  • Nag-expire na

Mga callback

Makatanggap ng mga papasok na Viber message callback para sa two-way na komunikasyon.

Mabilis na Pagsisimula

  1. Send a Message - Alamin kung paano ipadala ang iyong unang mensahe
  2. Tingnan ang Katayuan - Subaybayan ang katayuan ng paghahatid ng mensahe
  3. Mga Uri ng Mensahe - Galugarin ang iba't ibang uri ng mensahe

Format ng Kahilingan

Gumagamit ang lahat ng kahilingan sa format na JSON na may sumusunod na istraktura:

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

Format ng Tugon

Nagbabalik ang mga matagumpay na tugon:

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

Error sa Paghawak

Mga code ng status ng HTTP:

  • 200 OK - Matagumpay ang kahilingan
  • 400 Bad Request - Di-wastong format ng kahilingan
  • 401 Hindi awtorisado - Nabigo ang pagpapatunay
  • 429 Masyadong Maraming Kahilingan - Lumampas sa limitasyon sa rate
  • 500 Internal Server Error - Server error

Mga Susunod na Hakbang