Downlink — узнать статус кадра

Возвращает текущий статус кадра, поставленного в очередь командой downlink_data_req: ждёт ли он отправки, передан ли шлюзу, излучён ли в эфир или отклонён. Сервер ищет кадр по dataId из ответа на постановку в очередь.

Пригодится, если вы не подписаны на сообщения downlink_status или пропустили их, например при переподключении.

Запрос и ответ: downlink_ack_req → downlink_ack_resp.
Доступ: с токеном низкого уровня — устройства своего приложения и приложений, которые открыли ему доступ; с токеном высокого уровня — все устройства владельца.

Запрос

Поля без пометки «обязательно» можно не передавать.

Поле	Тип	Описание
cmd	string	downlink_ack_req
operation_id	string	Произвольная строка; сервер вернёт её в ответе — по ней сопоставляют запрос и ответ
devEui	string	Обязательно. DevEUI устройства, 16 hex-символов
dataId	uint32	Обязательно. Идентификатор кадра из downlink_data_resp

{
    "cmd": "downlink_ack_req",
    "operation_id": "abc",
    "devEui": "6F1E570FFE14DBFC",
    "dataId": 3046127811
}

Ответ

Поле	Тип	Описание
cmd	string	downlink_ack_resp
operation_id	string	Значение из запроса
dataId	uint32	Идентификатор кадра из запроса
downlink_status	uint8	Код статуса кадра, см. таблицу статусов
downlink_status_text	string	Название статуса, например Delivered
downlink_status_time	string	Когда статус установлен, UTC, формат ISO 8601
ack_time	string или null	Когда кадр получил итоговый статус, UTC, формат YYYY-MM-DD HH:MM:SS+0000; null, пока итогового статуса нет
status, error_code, error_text	uint8, uint8, string	Только при ошибке: status = 2, см. ниже

{
    "cmd": "downlink_ack_resp",
    "operation_id": "abc",
    "dataId": 3046127811,
    "ack_time": "2026-10-08 09:47:21+0000",
    "downlink_status": 3,
    "downlink_status_text": "Delivered",
    "downlink_status_time": "2026-10-08T09:47:21.402113+00:00"
}

Ошибки

error_code	error_text	Что случилось
1	dataId is required	Не указан dataId или devEui
2	Device not found	Кадра с таким dataId у этого устройства нет, или устройство недоступно с вашим токеном

Что важно знать

• В успешном ответе нет поля status. В описании v0.17 оно есть, но текущая версия сервера добавляет status только при ошибке. Признак успеха — наличие downlink_status.
• Подтверждение — от шлюза, а не от устройства. Статус 3 (Delivered) значит, что шлюз излучил кадр. Устройство приём не подтверждает: кадры уходят неподтверждаемыми.

См. также

• Отправка данных на устройство — сценарий целиком и статусы кадра.
• get_downlink_data_req — история отправленных кадров за период.