Անցնել պարունակությանը

SMSBAT API

SMSBAT-ը Հանգստացնող API հարթակ է տարբեր տեսակի հաղորդագրություններ ուղարկելու համար, ներառյալ Viber կարուսել, Viber կարծիքի երկխոսություն, Viber պրոմո (նկարներ, տեսանյութ), Viber բիզնես զրույց, OTP ծանուցումներ (Viber OTP, Flash Call) և դրանց հետադարձ տարբերակները:

Հիմնական URL

SMSBAT API-ին ուղղված հարցումները փոխանցվում են տեղայնացման վերջնակետ: Նախապես խնդրեք հասցեն ձեր մենեջերից:

Օրինակ՝ «https://restapi.smsbat.com» (փաստացի URL-ը կարող է տարբերվել՝ կախված ձեր տարածաշրջանից)

Նույնականացում

SMSBAT API-ն աջակցում է նույնականացման երեք եղանակ.

Մեթոդ 1. HTTP Հիմնական վավերացում

Օգտագործեք ձեր օգտանունը և գաղտնաբառը.

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

Մեթոդ 2. API բանալի վերնագիր

Օգտագործեք «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. API բանալի որպես գաղտնաբառ

Օգտագործեք «@» որպես օգտվողի անուն և ձեր API բանալին որպես գաղտնաբառ.

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

Հասանելի վերջնակետեր

Մեթոդ Վերջնակետ Նկարագրություն
ՓՈՍՏ /bat/messagelist Ուղարկել հաղորդագրություններ
ՍՏԱՆԱԼ /bat/message/{messageId} Ստուգեք հաղորդագրության կարգավիճակը

Հաղորդագրությունների տեսակները

SMSBAT API-ն աջակցում է հաղորդագրությունների հետևյալ տեսակներին.

  • **SMS ** - Ստանդարտ տեքստային հաղորդագրություններ
  • Viber Promo - Գովազդային հաղորդագրություններ հարուստ լրատվամիջոցներով
  • Viber Transaction - Գործարքների մասին ծանուցումներ
  • Viber Carousel - Ինտերակտիվ կարուսելային հաղորդագրություններ
  • Viber Survey - Կարծիքի երկխոսության հաղորդագրություններ
  • Viber OTP - Միանգամյա գաղտնաբառի ծանուցումներ
  • RCS - Հաղորդակցման ծառայությունների հարուստ հաղորդագրություններ
  • Ֆլեշ զանգ - Լուռ զանգի ստուգում

Հիմնական հատկանիշներ

Հետադարձ հաղորդագրություններ

Երբ առաջնային առաքումը ձախողվում է, SMSBAT-ն ավտոմատ կերպով վերադառնում է այլընտրանքային ալիքներին.

Viber → SMS → Email

Rich Media Support

Ուղարկեք հաղորդագրություններ հետևյալով.

  • Պատկերներ (JPG, PNG)
  • Տեսանյութեր (MP4)
  • PDF ֆայլեր
  • Կոճակներ և գործողության հղումներ

Հաղորդագրության կարգավիճակի հետևում

Հետևեք առաքման կարգավիճակին իրական ժամանակում.

  • Ուղարկվել է
  • Առաքված -Կարդացեք
  • Չհաջողվեց
  • Ժամկետանց ժամկետանց

Հետզանգեր

Ստացեք մուտքային Viber հաղորդագրությունների հետադարձ զանգեր երկկողմանի հաղորդակցության համար:

Արագ մեկնարկ

  1. Ուղարկել հաղորդագրություն - Իմացեք, թե ինչպես ուղարկել ձեր առաջին հաղորդագրությունը
  2. Ստուգեք կարգավիճակը - Հետևեք հաղորդագրությունների առաքման կարգավիճակին
  3. Հաղորդագրությունների տեսակները - Բացահայտեք հաղորդագրությունների տարբեր տեսակներ

Հարցման ձևաչափ

Բոլոր հարցումներն օգտագործում են JSON ձևաչափ հետևյալ կառուցվածքով.

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

Պատասխանի ձևաչափ

Հաջողված պատասխանները վերադարձվում են.

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

Սխալների մշակում

HTTP կարգավիճակի կոդերը.

  • «200 OK» - հարցումը հաջողվեց
  • «400 Վատ հարցում» - Անվավեր հարցումի ձևաչափ
  • «401 Չլիազորված» - Նույնականացումը ձախողվեց
  • «429 Չափազանց շատ հարցումներ» - Գնահատման սահմանաչափը գերազանցվել է
  • 500 ներքին սերվերի սխալ - Սերվերի սխալ

Հաջորդ քայլերը