Status

API-интерфейс /osc/commands/status возвращает состояние команд, ранее бывших в состоянииinProgress. API-интерфейс status удобен для отслеживания выполнения отправленных команд; например, определение завершения camera.takePicture.

Ввод

Имя Тип Описание
id Строка Идентификатор команды, возвращенный предыдущим вызовом /osc/commands/execute.

Вывод

Выводится также объект команды (см. Вывод в описании интерфейса /osc/commands/execute).

Ошибка

Код ошибки Описание
missingParameter Не указан id. Для данного параметра требуется идентификатор команды, возвращенный предыдущим вызовом /osc/commands/execute.
invalidParameterName Входной параметр не распознан.
invalidParameterValue Входной параметр распознан, но его значение не является допустимым; например, значение id не существует или имеет неверный тип.

Пример

Запрос
POST /osc/commands/status HTTP/1.1
Host: [camera ip address]:[httpPort]
Content-Type: application/json;charset=utf-8
Accept: application/json
Content-Length: {CONTENT_LENGTH}
X-XSRF-Protected: 1

{
    "id": "90ABCD"
}
Ответ
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "name": "camera.takePicture",
    "state": "done",
    "results": {
        "fileUri": "ABC.JPG"
    }
}