SMS HTTP API
Отправка SMS-сообщений
Запрос:
POST/GET https://api.unibell.tech/sms_new?X-Authorization=AccessKey d8ac9959r12b43545XXXXX&destAddr=7917XXXXXXX&sourceAddr=XXXXX&short Message=Привет, как дела?
| Параметр | Тип | Описание |
|---|---|---|
| destAddr | string | Номер телефона, на который отправляется SMS-сообщение в формате e.164 для Российской Федерации 7XXXXXXXXXX |
| sourceAddr | string | Имя отправителя |
| shortMessage | string | Текст сообщения |
Ответ:
{
“reference”: “5b922bba6be053cd6a2ecebb1a31438a”,
“status”: “ok”,
}| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус запроса смотрите выше |
| reference | string | Уникальный идентификатор сообщения |
Для получения результатов выполнения запроса может быть настроен callback (обратный вызов) по протоколу HTTP/HTTPS с помощью метода POST. Передаются параметры Content-Type: application/x-www-form-urlencoded.
| Параметр | Тип | Описание |
|---|---|---|
| reference | string | Уникальный идентификатор сообщения |
| sourceAddr | string | Имя отправителя |
| destAddr | string | Номер телефона, на который отправляется SMS-сообщение в формате e.164 для Российской Федерации 7XXXXXXXXXX |
| status | string | Статус SMS-сообщения DELIVERED — доставлено UNDELIVERABLE — не доставлено (уточнение в коде сетевой ошибки) REJECTED — отклонено с ошибкой (уточнение в коде сетевой ошибки) |
| networkErrCode | string | Ошибки SS7, смотрите ниже |
| imsi | string | IMSI абонента |
| vlr | string | VLR абонента |
| hlr | string | HLR абонента |
| createdDateTime | string | Дата/время создания |
| statusDateTime | string | Дата/время получения статуса |
Коды ошибок в статусе
Возможные коды ошибок в статусе SMS-сообщений или запросов HLR (значения networkErrCode), все неуказанные коды считаются зависящими от поставщика и не обрабатываются отдельно:
| Код | Имя | Описание |
|---|---|---|
| 0 | Нет ошибки | Абонент существует и доступен |
| 1 | Абонент не существует | Указанный номер телефона не существует |
| 6 | Абонент находится в автономном режиме | Телефон абонента отключен или находится вне зоны действия сети |
| 11 | Нет услуги отправки SMS-сообщений | Означает, что абонент не может получить SMS-сообщение. Например, услуга не подключена, или абонент находится в роуминге, где не активирован прием сообщений, или у оператора абонента нет обмена SMS-сообщениями с текущим оператором в роуминге. Это также может быть городской номер, по которому не принимаются сообщения |
| 12 | Ошибка в телефоне абонента | Сообщение не может быть доставлено абоненту из-за ошибки в телефоне или SIM-карте |
| 13 | Абонент заблокирован | Возникает, например, если на счете абонента нулевой или отрицательный баланс, и он находится в роуминге, или заблокирован оператором за длительную неуплату, или добровольно самим абонентом. Кроме того, эта ошибка может повториться, если SIM-карта повреждена или неправильно введены PIN- и PUK-коды SIM-карты |
| 21 | Нет сервисной поддержки | Устройство абонента не поддерживает работу с данной услугой (сервисом) |
На этой странице