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

Создаёт приложение у того же владельца, что и приложение текущего подключения, и выпускает для него токен низкого уровня. С app_id и токеном из ответа можно сразу подключиться от имени нового приложения, а по app_eui — создавать в нём устройства командой create_device_req. Данные новое приложение отдаёт через WebSocket.

Запрос и ответ: create_application_req → create_application_resp.
Доступ: только токен высокого уровня. С токеном низкого уровня сервер ответит ошибкой 1.

Запрос

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

Поле	Тип	Описание
cmd	string	create_application_req
operation_id	string	Произвольная строка; сервер вернёт её в ответе — по ней сопоставляют запрос и ответ
appName	string	Обязательно. Название приложения. Уникальность не проверяется

{
    "cmd": "create_application_req",
    "operation_id": "abc",
    "appName": "testApp"
}

Ответ

Поле	Тип	Описание
cmd	string	create_application_resp
operation_id	string	Значение из запроса
status	uint8	1 — приложение создано, 2 — ошибка
app_id	string	Идентификатор приложения, 8 hex-символов. Нужен для подключения
app_eui	string	AppEUI приложения, 16 hex-символов
token	string	Токен низкого уровня, 22 символа: латинские буквы и цифры
error_code, error_text	uint8, string	Только при ошибке, см. ниже

{
    "cmd": "create_application_resp",
    "operation_id": "abc",
    "status": 1,
    "app_id": "358098F3",
    "app_eui": "258BD226017CBF01",
    "token": "737x6WuNdSBC4VFWhuyHHz"
}

Ошибки

error_code	error_text	Что случилось
1	Unauthorized access	Запрос пришёл с токеном низкого уровня
2	Required field is not filled	Не указано appName или оно пустое
3	Unexpected error	Сервер не смог записать приложение или токен. Если не записался токен, приложение уже создано — проверьте командой get_applications_req
0	—	Внутренняя ошибка сервера — повторите запрос позже

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

• Повтор создаёт второе приложение. Название не обязано быть уникальным, поэтому запрос, повторённый после обрыва связи, создаст ещё одно приложение. Перед повтором проверьте список командой get_applications_req.
• Токен из ответа — низкого уровня: с ним доступны устройства своего приложения, а создавать устройства и приложения нельзя.

См. также

• get_applications_req — список приложений и их токенов.
• delete_application_req — удалить приложение.