Удаление устройства

Удаляет устройство пользователя.

Формат запроса

DELETE https://api.iot.yandex.net/v1.0/devices/{device_id}

device_id

Идентификатор устройства пользователя.

Заголовки запроса

Заголовок

Описание

Обязательный

Authorization

Авторизационный токен oauth-приложения.

Да

Формат ответа

HTTP/1.1 200 OK

{
    "request_id": String,
    "status": "ok"
}

Параметр

Тип

Описание

Обязательный

request_id

String

Идентификатор запроса. Необходимо логировать для расследования инцидентов.

Да

status

String

Статус обработки запроса. Допустимые значения:

  • ok.

Да

HTTP/1.1 404 Not Found

{
    "request_id": String,
    "status": "error",
    "message": String
}

Параметр

Тип

Описание

Обязательный

request_id

String

Идентификатор запроса. Необходимо логировать для расследования инцидентов.

Да

status

String

Статус обработки запроса. Допустимые значения:

  • error.

Да

message

String

Сообщение об ошибке.

Нет

Коды ошибок

Пример

curl -i -X DELETE 'https://api.iot.yandex.net/v1.0/devices/device-id-1' \
-H 'Authorization: Bearer 123qwe456a...'
HTTP/1.1 200 OK

{
    "request_id": "667b3e0f-47a8-4136-9211-b4ff59062315",
    "status": "ok"
}
HTTP/1.1 404 Not Found

{
    "request_id": "667b3e0f-47a8-4136-9211-b4ff59062315",
    "status": "error",
    "message": "Устройство не найдено"
}

Служба поддержки

Cтрока, выделяется кавычками, например "Hello world".

Идентификатор устройства пользователя.

Тип

String

Описание

Идентификатор запроса. Необходимо логировать для расследования инцидентов.

Обязательный

Да

Тип

String

Описание

Статус обработки запроса. Допустимые значения:

  • ok.

Обязательный

Да

Тип

String

Описание

Статус обработки запроса. Допустимые значения:

  • error.

Обязательный

Да

Тип

String

Описание

Сообщение об ошибке.

Обязательный

Нет