Ushbu hujjatda HTTP(S) protokoli orqali xabarlarni platformaga uzatish imkonini beruvchi JSONv2 protokoli haqidagi maʼlumotlar mavjud.
Ushbu hujjat tayyorlanish vaqtidagi ma'lumotlarni o'z ichiga oladi. Ishlab chiqaruvchi ushbu hujjatda xatolik yo'qligiga kafolat bermaydi. Ishlab chiqaruvchi hujjatga oldindan ogohlantirmasdan o'zgartirish kiritish huquqini o'zida saqlab qoladi
Ushbu hujjatning hech bir qismini ishlab chiqaruvchiga yozma ravishda ogohlantirmasdan har qanday shaklda yoki biron-bir vosita bilan qayta ishlab chiqarish yoki uzatish mumkin emas
Ishlab chiqaruvchi ushbu hujjatda ko'rsatilgan dasturiy ta'minot xatosiz ekanligiga, o'zboshimchalik bilan tanlangan sharoitlarda ishlashiga va unga qo'yilishi mumkin bo'lgan barcha talablarga javob berishiga kafolat bermaydi.
Ishlab chiqaruvchi noqonuniy olingan dasturiy ta'minotning ishlashiga kafolat bermaydi. Dasturiy ta'minot va unga tegishli hujjatlardan noqonuniy foydalanish qonun bilan taqiqlanadi
JSONv2 protokoli HTTP(S) protokoli orqali platformaga xabar yuborish imkonini beradi.
Platforma server vazifasini bajaradi. Yetkazib berish uchun xabar yuborayotgan mijozlar HTTP mijozlari sifatida ishlaydi.
Yagona xabarni yetkazib berish stsenariysi:
Ommaviy yuborishning sinxronlash turini ishga tushirish uchun skript (to‘plam yoki translyatsiya):
Parametr | Qiymat |
---|---|
API URL manzili | [JSONv2_URL]/{client_id}/json2/simple |
Usul | POST |
HTTPAautentifikatsiya | Asosiy |
Majburiy sarlavha | Kontent turi: application/json |
{ "telefon_raqami": 79651111111, "extra_id": "AD-6640-7006", "callback_url": "https://send-dr-here.com", "start_time": "2020-12-12 10:10:10+03:00", "teg": "Kampaniya nomi", "kanallar": [ "SMS" ], "kanal_opsiyalari": { "SMS": { "text": "SMS uchun matn", "alpha_name": "Test", "ttl": 300 } } }
HTTP holati 200 OK, so‘rovingiz server tomonidan muvaffaqiyatli bajarilganligini bildiradi.
Agar so'rov to'g'ri bo'lsa, siz quyidagi javobni olasiz:
{"message_id":"9f60ac8f-e721-5027-b838-e6fcb95fcd7a"}
Agar so‘rovda xatolik bo‘lsa yoki ulanish sozlamalariga mos kelmasa, siz quyidagi javobni olasiz:
{"error_code":36024,"error_text":"Telefon raqami noto'g'ri"}
Platforma soʻrovga javob qaytaradi (Ommaviy xabarlarni yuborish soʻroviga javob boʻlimiga qarang).
To'plamli SMS xabarlar uchun so'rov namunasi:
{ "xabarlar": [ { "telefon_raqami": 79651111111, "extra_id": "AD-6640-7006", "text": "Barcha kanallar uchun matn, qabul qiluvchi #79651111111" }, { "telefon_raqami": 79652222222, "extra_id": "AD-6640-7007", "text": "Barcha kanallar uchun matn, qabul qiluvchi #79652222222" } ], "start_time": "2020-12-12 10:10:10+03:00", "teg": "Kampaniya nomi", "kanallar": [ "SMS" ], "kanal_opsiyalari": { "SMS": { "alpha_name": "Test", "ttl": 300 } } }
HTTP holati 200 OK, so‘rovingiz server tomonidan muvaffaqiyatli bajarilganligini bildiradi.
SMS xabarlarini translyatsiya qilish uchun so'rov namunasi:
{ "qabul qiluvchilar": [ { "telefon_raqami": 79651111111, "extra_id": "AD-6640-7006", "ism": "Maykl", "salom": "janob" }, { "telefon_raqami": 79652222222, "extra_id": "AD-6640-7007", "name": "Zoya", "salom": "Xonim" } ], "start_time": "2020-12-12 10:10:10+03:00", "teg": "Kampaniya nomi", "kanallar": [ "SMS" ], "kanal_opsiyalari": { "SMS": { "text": "Hurmatli %salom% %name%! Mana SMS", "alpha_name": "Test", "ttl": 300 } } }
{ "qabul qiluvchilar": [ { "telefon_raqami": 79651111111, "extra_id": "AD-6640-7006", "ism": "Maykl", "salom": "janob" }, { "telefon_raqami": 79652222222, "extra_id": "AD-6640-7007", "name": "Zoya", "salom": "Xonim" } ], "start_time": "2020-12-12 10:10:10+03:00", "teg": "Kampaniya nomi", "kanallar": [ "SMS" ], "kanal_opsiyalari": { "SMS": { "text": "Hurmatli %salom% %name%! Mana SMS", "alpha_name": "Test", "ttl": 300 } }, "sms_kirill": { "min": 0, "maksimal": 1340 }, "sms_latin": { "min": 0, "maksimal": 3060 } }
HTTP holati 200 OK, so‘rovingiz server tomonidan muvaffaqiyatli bajarilganligini bildiradi.
{"job_id": "66591729-cb47-5ef9-964b-949dc6aff84f"}
Ushbu job_id yordamida siz kampaniya holati (pochta roʻyxati) haqida hisobot soʻrashingiz mumkin.
{ "xabarlar": [ { "qayta ishlangan": rost, "telefon_raqami": "79651111111", "message_id": "9f60ac8f-e721-5027-b838-e6fcb95fcd7a", "extra_id": "AD-6640-7006", "qabul qilingan": rost }, { "qayta ishlangan": rost, "telefon_raqami": "79652222222", "message_id": "e5ea7286-6849-52d7-9e1b-8719b736283e", "extra_id": "AD-6640-7007", "qabul qilingan": rost } ] }
{ "xabarlar": [ { "vaqt": 1477417299000, "telefon_raqami": "79652222222", "message_id": "e5ea7286-6849-52d7-9e1b-8719b736283e", "extra_id": "AD-6640-7007", "qayta ishlangan": noto'g'ri, "qabul qilingan": rost, "total_sms_parts": 1, "error_text": "SMS muddati tugadi", "xato_kodi": 35015 }, { "vaqt": 1477417294667, "telefon_raqami": "79651111111", "message_id": "9f60ac8f-e721-5027-b838-e6fcb95fcd7a", "extra_id": "AD-6640-7006", "qayta ishlangan": noto'g'ri, "qabul qilingan": rost, "total_sms_parts": 1, "delivered_sms_parts": 1, "status_text": "SMS yetkazib berildi", "holat": 2, "substatus": 23, "msghub_status": 23011 } ] }
HTTP holati 200 OK, so‘rovingiz server tomonidan muvaffaqiyatli bajarilganligini bildiradi
Hisobot parametrlari tavsifi uchun pastga qarang
{ "raqam": 79651111111, "vaqt": 1477417294667, "holat": 2, "substatus": 23, "msghub_status": 23011, "message_id": "9f60ac8f-e721-5027-b838-e6fcb95fcd7a", "extra_id": "AD-6640-7006", "sent_via": "sms" }
[ { "raqam": "79651111111", "vaqt": 1477417294667, "holat": 2, "substatus": 23, "msghub_status": 23011, "message_id": "9f60ac8f-e721-5027-b838-e6fcb95fcd7a", "extra_id": "AD-6640-7006", "sent_via": "sms" }, { "raqam": "79652222222", "vaqt": 1477417299000, "holat": 3, "substatus": 35, "msghub_status": 35015, "message_id": "e5ea7286-6849-52d7-9e1b-8719b736283e", "extra_id": "AD-6640-7007", "sent_via": "sms" }, { "raqam": "79653333333", "vaqt": 1477417299050, "holat": 2, "substatus": 23, "msghub_status": 23033, "message_id": "8a3ff6c5-a1fb-4849-a54b-3c488753cb8b", "extra_id": "AD-6640-7008", "sent_via": "sms" } ]
Etkazib berish hisobotida xabarning yakuniy holati mavjud.
Xabar identifikatori boʻyicha hisobot olish uchun quyidagi URL manzilidan foydalaning:
[JSONv2_URL]/{client_id}/dr/{message_id}/simple
Qoʻshimcha identifikator yordamida hisobot olish uchun quyidagi URL manzilidan foydalaning:
[JSONv2_URL]/{client_id}/dr/external/{extra_id}/oddiy
Oddiy yetkazib berish hisoboti misoli:
{ "telefon_raqami": "79651111111", "last_partner": "sms", "message_id": "9f60ac8f-e721-5027-b838-e6fcb95fcd7a", "extra_id": "AD-6640-7006", "vaqt": 1477417294667, "holat": 2, "substatus": 23, "msghub_status": 23011, "total_sms_parts": 1, "delivered_sms_parts": 1 }
HTTP holati 200 OK, so‘rovingiz server tomonidan muvaffaqiyatli bajarilganligini bildiradi.
Xabar identifikatori boʻyicha hisobot olish uchun quyidagi URL manzilidan foydalaning:
[JSONv2_URL]/{client_id}/dr/{message_id}/advanced
Qo'shimcha identifikator yordamida hisobot olish uchun quyidagi URL manzilidan foydalaning:
[JSONv2_URL]/{client_id}/dr/external/{extra_id}/advanced
Batafsil yetkazib berish hisobotiga misol:
{ "hisobotlar": [ { "telefon_raqami": "79651111111", "message_id": "9f60ac8f-e721-5027-b838-e6fcb95fcd7a", "extra_id": "AD-6640-7006", "vaqt": 1477417294667, "last_partner": "sms", "holat": 3, "substatus": 35, "msghub_status": 35015 }, { "telefon_raqami": "79651111111", "message_id": "9f60ac8f-e721-5027-b838-e6fcb95fcd7a", "extra_id": "AD-6640-7006", "vaqt": 1477417294667, "last_partner": "sms", "holat": 2, "substatus": 23, "msghub_status": 23011, "total_sms_parts": 1, "delivered_sms_parts": 1 } ], "boshlandi": rost, "qayta ishlash": noto'g'ri, "delivered_via": "sms", "kanallar": [ { "kanal": "sms", "ttl": 300 } ] }
HTTP holati 200 OK, so‘rovingiz server tomonidan muvaffaqiyatli bajarilganligini bildiradi
Birlamchi GSM 7-bitli alifbo belgilarining kengaytirilgan jadvali:
Javob parametrlarining tavsifi:
belgilangan bo'limida sozlangan. tomonidan rad etilsa, noto'g'riXabar yetkazib berish hisoboti parametrlarining tavsifi:
belgilangan boʻladi tomonidan rad etilsa, qiymat noto'g'ri bo'ladi bilan boshlangan bo'lsa, qiymat noto'g'ri hisoblanadi“Status”ning soddalashtirilgan ma’nosi – holat:
"Substatus" ning kengaytirilgan ma'nosi - substatuslar: