Параметры запроса
Параметр
|
Описание
|
Обязательный
|
id
|
Идентификатор группы
|
да
|
link-text
|
Макрос {link} будет заменен на строку, указанную в данном параметре
|
нет
|
link-url
|
Ссылка на страницу, которая будет открываться при клике на {link}
|
нет
|
logo
|
Логотип в формате BMP (24-битные изображения в кодировке base64)
|
нет
|
logo-text
|
Текст, размещаемый справа от логотипа, например, название компании
|
нет
|
logo-url
|
Ссылка на страницу, которая будет открываться при клике на логотип
|
нет
|
message
|
Текст сообщения, отправляемого станции.
Текст сообщения может содержать макрос {link}
|
да
|
Пример запроса
http://192.168.1.1:9080/api/groups/send-message.ds?message=TEST_MSG&id=1&logo=logo_base64&logo-text=logo-text&logo-url=www.logo.ru&link-text=test%20text&link-url=www.url.ru
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.0" timestamp="1558521911" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<stations total="3">
<station id="203fe068-d21d-b211-ac5b-840701ce1bdd" status="delayed"/>
<station id="50b63369-d21d-b211-ac61-840701ce1bdd" status="delayed"/>
<station id="30fa7468-d21d-b211-ac55-840701ce1bdd" status="delayed"/>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию по станциям, на которые отправлялось сообщение.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций
|
•Элемент <station /> содержит информацию о конкретных станциях, на которые отправлялось сообщение. Атрибуты элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
status
|
Статус процесса отправки сообщения. Может принимать следующие значения:
•delayed — отправка отложена, •failed — отправка завершилось с ошибкой, •initiated — отправка инициирована. |
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1558521992,
"api": {
"version": 40300,
"versionString": 4.3.0},
"server": {
"name": "192.168.1.1",
"version": "12.00.0.201909260",
"uuid": "27671337-e0b0-4f60-aeb0-ab1f2ca47f77"}},
"data": {
"total": 3,
"list": {
"203fe068-d21d-b211-ac5b-840701ce1bdd": "delayed",
"50b63369-d21d-b211-ac61-840701ce1bdd": "delayed",
"30fa7468-d21d-b211-ac55-840701ce1bdd": "delayed"}}}
|
Описание параметров ответного JSON
Блок data содержит информацию обо всех станциях, на которые отправлялось сообщение.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций, на которые отправлялось сообщение
|
•Массив list содержит информацию о конкретных станциях, на которые отправлялось сообщение. Элементы объектов в массиве list:
Название поля
|
Описание
|
Идентификатор станции, на которую отправлялось сообщение
|
Статус процесса отправки сообщения. Может принимать следующие значения:
•delayed — отправка отложена, •failed — отправка завершилось с ошибкой, •initiated — отправка инициирована. |
|