SMSBAT API

SMSBAT არის RESTful 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 Transactions - ტრანზაქციის შეტყობინებები
Viber Carousel - ინტერაქტიული კარუსელის შეტყობინებები
Viber Survey - აზრის დიალოგის შეტყობინებები
Viber OTP - პაროლის ერთჯერადი შეტყობინებები
RCS - მდიდარი საკომუნიკაციო სერვისების შეტყობინებები
Flash Call - ჩუმი ზარის გადამოწმება

ძირითადი მახასიათებლები

სარეზერვო შეტყობინებები

როდესაც პირველადი მიწოდება ვერ ხერხდება, SMSBAT ავტომატურად ბრუნდება ალტერნატიულ არხებზე:

Viber → SMS → Email

მდიდარი მედია მხარდაჭერა

გაგზავნეთ შეტყობინებები:

სურათები (JPG, PNG)
ვიდეოები (MP4)
PDF ფაილები
ღილაკები და სამოქმედო ბმულები

შეტყობინების სტატუსის თვალყურის დევნება

თვალყური ადევნეთ მიწოდების სტატუსს რეალურ დროში:

გაგზავნილი
მიიტანეს
წაიკითხე
ჩაიშალა
ვადა გაუვიდა

გამოძახებები

მიიღეთ შემომავალი Viber შეტყობინების გამოძახებები ორმხრივი კომუნიკაციისთვის.

სწრაფი დაწყება

Send a Message - ისწავლეთ როგორ გაგზავნოთ თქვენი პირველი შეტყობინება
სტატუსის შემოწმება - თვალყური ადევნეთ შეტყობინების მიწოდების სტატუსს
შეტყობინებების ტიპები - შეისწავლეთ სხვადასხვა ტიპის შეტყობინებები

მოთხოვნის ფორმატი

ყველა მოთხოვნა იყენებს 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 შიდა სერვერის შეცდომა - სერვერის შეცდომა

შემდეგი ნაბიჯები

Send Message - დაიწყეთ შეტყობინებების გაგზავნა
Viber Messages - შეიტყვეთ Viber შეტყობინებების ტიპების შესახებ
SMS Messages - SMS შეტყობინებების გაგზავნა
RCS Messages - მდიდარი საკომუნიკაციო სერვისები
Flash Call - ტელეფონის დადასტურება
სტატუსის შემოწმება - მიწოდების სტატუსის თვალყურის დევნება