Удалить приложение

Удаляет приложение владельца по AppEUI. Приложение помечается удалённым: оно пропадает из ответа на get_applications_req, а подключиться с его токенами больше нельзя.

Запрос и ответ: delete_application_req → delete_application_resp.
Доступ: только токен высокого уровня; можно удалить любое приложение владельца, в том числе то, к которому вы подключены. С токеном низкого уровня сервер ответит ошибкой 1.

Текущая версия ONS

Кодов 4 (Application used) и 5 (Unexpected error) сервер не возвращает: приложение удаляется, даже если в нём есть устройства.

Запрос

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

Поле	Тип	Описание
cmd	string	delete_application_req
operation_id	string	Произвольная строка; сервер вернёт её в ответе — по ней сопоставляют запрос и ответ
appEui	string	Обязательно. AppEUI приложения, 16 hex-символов; регистр букв имеет значение

{
    "cmd": "delete_application_req",
    "operation_id": "cdma",
    "appEui": "258BD226017CBF01"
}

Ответ

Поле	Тип	Описание
cmd	string	delete_application_resp
operation_id	string	Значение из запроса
status	uint8	1 — приложение удалено, 2 — ошибка
error_code, error_text	uint8, string	Только при ошибке, см. ниже

{
    "cmd": "delete_application_resp",
    "operation_id": "cdma",
    "status": 1
}

Ошибки

error_code	error_text	Что случилось
1	Unauthorized access	Запрос пришёл с токеном низкого уровня
2	appEui is required	Не указан appEui
3	Application not found	У владельца нет приложения с таким appEui, или оно уже удалено

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

• Устройства приложения не удаляются. Перед удалением приложения удалите их командой delete_device_req или перенесите в другое приложение командой update_device_req с полем application_eui. После удаления приложения delete_device_req эти устройства уже не найдёт.
• Повтор безопасен. На повторный запрос сервер ответит ошибкой 3: приложение уже удалено.

См. также

• get_applications_req — список приложений.
• create_application_req — создать приложение.