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"
}
} |