SMS#

Отправка SMS-сообщения#

POST https://external-api.i-dgtl.ru/message

Метод позволяет отправить одиночное SMS-сообщение.

Headers#

Name

Type

Description

Content-Type

string

application/json

Authorization

string

„nodeID:password“ | base64

Request Body#

Name

Type

Description

@type

string

Тип сообщения, имеет постоянное значение оutbound (исходящее).

addresses

object

Объект, содержащий адреса отправителя и получателя.

source

string

Имя или адрес отправителя.

destination

string

Адрес или номер телефона получателя.
Указывается в международном формате MSISDN, состоящем из кода страны, DEF-кода оператора и номера абонента.
Например, российский номер выглядит так: 79001234567, где 7 - код страны (Россия).

body

object

Объект, в котором передаётся содержимое сообщения.

bodyType

string

Тип сообщения (SMS)

content

string

Текст сообщения.
Строка.*

nodeId

integer

Номер ноды

requestDelivery

boolean

Указывает, cледует ли предоставлять отчёт о доставке после отправки сообщения (true|false).

expirationDate

integer

Время, до которого будет ожидаться получение статуса от оператора.
Тип значения - timestamp в миллисекундах или в формате ISO 8601.
По умолчанию составляет 24 часа с момента отправки сообщения.

{
    "id": "10147aa1-6311-0190-4215-aa0000000002",
    "timestamp": 1611057190000,
    "code": 200
}
{
    "timestamp": 1632211974626,
    "code": 400,
    "description": "incorrect request body"
}

Пример запроса#

POST https://external-api.i-dgtl.ru/message
Authorization: Basic Mzk5OTk6MTIzNjU0
Content-Type: application/json

{
    "@type": "outbound",
    "addresses": {
        "source": "Testing",
        "destination": "79500197493"
    },
    "body": {
        "bodyType": "text",
        "content": "Have a nice day!"
    },
    "nodeId": 31937,
    "requestDelivery": true
}

*Будьте внимательны при использовании в SMS следующих символов:

£,¥,è,é,ù,ì,ò,Ç,Ø,ø,Å,å,Δ,Φ,Γ,Λ,Ω,Π,Ψ,Σ,Θ,Ξ,Æ,æ,ß,É,¤,¡,Ä,Ö,Ñ,Ü,§ ¿,ä,ö,ñ,ü,à, NUL,SOH,STX,ETX,EOT,ENQ,ACK,BEL,BS,TAB,VT,SO,SI,DLE,DC1,DC2,DC3,DC4,NAK, SYN,ETB,CAN,EM,SUB,FS,GS,RS,US,`,DEL.