notify_url

GET

http://vashserver-sms-status.kz/status

Общая схема работы с параметром notify_url

В запросе на отправку смс сообщения send или sendbulk Вы указываете URL Вашего "приемщика" в параметре notify_url, без каких либо параметров, например, http://vashserver-sms-status.kz/status
При обновлении статуса мы вызываем Ваш URL и передаем на него следующие параметры с данными (секция Params)

CAUTION

Внимание! Ваш "приемщик" должен обрабатывать именно такие название параметров (секция Params).

CAUTION

Передача осуществляетя только методом GET по HTTP или HTTPS

Пример запроса на Ваш "приемщик": http://vashserver-sms-status.kz/status?bulk_id=c952d0a96482084116780c89&message_id=6&extra_id=123Y&to=77011234567&sender=KiT_Notify&sent_at=2022-09-21 10:01:54&done_at=2022-09-21 10:01:56&sms_count=1&status=delivered&mnc=2&err=

INFO

Для генерации примера кода "приемщика" на нужном языке программирования, можете воспользоваться кнокой "</> Code Generate" в правом углу. Внести необходимые Вам изменения и разместить на Вашем сервере.

📌

Тех. поддержка: support@kazinfoteh.kz

Request

Query Params

bulk_id

string

required

ID массовой рассылки.

Example:

c952d0a96482084116780c89

message_id

string

required

Уникальный ID конкретного сообщения в нашей системе

Example:

extra_id

string

required

Ваш ID, если указывали в запросе поле extra_id

Example:

123Y

string

required

Номер телефона

Example:

77011234567

sender

string

required

Заголовок (сендер) сообщения

Example:

KiT_Notify

sent_at

string

required

Дата и время отправки в фотмате YYY-MM-DD HH:mm:SS

Example:

2022-09-21 10:01:54

done_at

string

required

Дата и время доставки/не доставки в фотмате YYY-MM-DD HH:mm:SS (если есть)

Example:

2022-09-21 10:01:56

sms_count

string

required

Количество смс сообщений в длинном сообщении.

Example:

status

string

required

Статус сообщения:
send - в очереди на отправку
sending - в процессе отправка
sent - доставлено до оператора
delivered - доставлено до абонента
undelivered - не доставлено до абонента

Example:

delivered

mnc

string

required

Международный код оператора:
1 - Билайн
2 - Кселл
77 - Теле2
7 - Алтел
55 - Другие операторы

Example:

err

string

required

Описание ошибки (если есть)

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://vashserver-sms-status.kz/status?bulk_id=c952d0a96482084116780c89&message_id=6&extra_id=123Y&to=77011234567&sender=KiT_Notify&sent_at=2022-09-21 10:01:54&done_at=2022-09-21 10:01:56&sms_count=1&status=delivered&mnc=2&err='

Responses

🟢200OK

application/json

Body

object {0}

Example

{}

Modified at 2023-09-21 13:38:58

getSenders

SOAP SMS API