sendBulk

POST

https://so.kazinfoteh.org/api/sms/send/bulk

Запрос для отправки массовой рассылки смс сообщения. В одном запросе множество телефонов

INFO

TIP

Токен авторизации, формируется из login:password и кодированный в base64
К токену в начало добавляется слово Basic
Basic base64.encode(login:password)

Пример заголовка авторизации: Basic cGFydG5lc2dwZEZLUXQ=

TIP

Для каждого номера телефона (абонента) можно задавать свой персональный текст, заголовок (сендер)

Лимит: Не более 20 000 номеров в одном запросе

📌

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

Request

Header Params

Authorization

string

optional

Токен авторизации, формируется из login:password и кодированный в base64
Basic base64.encode(login:password)

Example:

Basic cGFydG5lc2dwZEZLUXQ=

Content-Type

string

optional

Example:

application/json

Body Params application/json

array of:

from

string

required

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

>= 3 characters<= 17 characters

Example:

KiT_Notify

string

required

Номер телефона в формате 7XXXXXXXXX (без 8 и без +, например 77011234567)

>= 11 characters<= 15 characters

Example:

77011234567

text

string

required

Текст смс сообщения. Возможно отправка на каждый номер персонального текста

>= 1 characters<= 1000 characters

Example:

txt1

sent_at

string

optional

Если необходимо то возможно указать дату и время, когда должна быть отпарвлено сообщение. Дата и время в фотмате YYY-MM-DD HH:mm:SS

Example:

2022-09-21 09:19:41

extra_id

string

optional

Ваш ID сообщения. Вы можете указать Ваш ID сообщения, из Вашей системы.

>= 1 characters<= 50 characters

Example:

123Y

notify_url

string

optional

Ваш URL "приемщик" (webhook) для получения статусов сообщений от нас. Подробнее в секции notify_url

>= 11 characters<= 255 characters

Example:

http://vashserver.kz/status

prioritet

integer

optional

Приоритет сообщения в пределах подключения
0 - По умолчанию. Обычный приоритет
1 - Повышенный приоритет, смс будет отправлена вперед чем смс с приоритетом 0

Default:

Example

[
{	"from": "KiT_Notify",
	"to": "77011234567",
	"text": "txt1",
	"sent_at": "2020-03-16 10:00:24",
	"extra_id": "1Y",
	"notify_url": "http://vashserver.kz/status"
},

{	"from": "KiT_Notify",
	"to": "77011234568",
	"text": "txt2",
	"sent_at": "2020-03-16 10:00:24",
	"extra_id": "2Y",
	"notify_url": "http://vashserver.kz/status"
}
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://so.kazinfoteh.org/api/sms/send/bulk' \
--header 'Authorization: Basic cGFydG5lc2dwZEZLUXQ=' \
--header 'Content-Type: application/json' \
--data-raw '[
{	"from": "KiT_Notify",
	"to": "77011234567",
	"text": "txt1",
	"sent_at": "2020-03-16 10:00:24",
	"extra_id": "1Y",
	"notify_url": "http://vashserver.kz/status"
},

{	"from": "KiT_Notify",
	"to": "77011234568",
	"text": "txt2",
	"sent_at": "2020-03-16 10:00:24",
	"extra_id": "2Y",
	"notify_url": "http://vashserver.kz/status"
}
]'

Responses

🟢200OK

application/json

Body

array of:

bulk_id

string

required

ID массовой рассылки. Если в запросе не один номер телефона, а список номеров. У всего списка номеров будет одинаковый ID рассылки.

>= 24 characters<= 24 characters

message_id

string

required

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

extra_id

string | null

required

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

string

required

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

sender

string

required

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

text

string

required

Текст сообщения

sent_at

string

required

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

done_at

string | null

required

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

sms_count

string

required

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

priority

string

required

Приоритет сообщения

callback_data

string | null

required

Дополнительные данные, которые были отправлены на notify_url (если есть)

status

enum<string>

required

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

Allowed values:

sendsendingsentdeliveredundelivered

mnc

enum<string>

required

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

Allowed values:

1277755

err

string | null

required

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

Example

[
    {
        "bulk_id": "c4225cdc09d305b21beccae8",
        "message_id": "9",
        "extra_id": "1Y",
        "to": "77011234567",
        "sender": "KiT_Notify",
        "text": "txt1",
        "sent_at": "2023-09-21 10:43:08",
        "done_at": null,
        "sms_count": "1",
        "priority": "0",
        "callback_data": null,
        "status": "send",
        "mnc": "2",
        "err": null
    },
    {
        "bulk_id": "c4225cdc09d305b21beccae8",
        "message_id": "10",
        "extra_id": "2Y",
        "to": "77011234568",
        "sender": "KiT_Notify",
        "text": "txt2",
        "sent_at": "2023-09-21 10:43:08",
        "done_at": null,
        "sms_count": "1",
        "priority": "0",
        "callback_data": null,
        "status": "send",
        "mnc": "2",
        "err": null
    }
]

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

send

reportByID

sendBulk

Запрос для отправки массовой рассылки смс сообщения. В одном запросе множество телефонов#

Request

Request samples

Responses

Запрос для отправки массовой рассылки смс сообщения. В одном запросе множество телефонов