La /osc/commands/status
API devuelve la condición de comandos inProgress
anteriores. La status
API es útil para sondear el progreso de un comando emitido con anterioridad; por ejemplo, para determinar si se completó camera.takePicture
.
Entrada
Nombre |
Tipo |
Descripción |
id |
Cadena |
Id. de comando devuelto por una llamada previa a /osc/commands/execute. |
Salida
La salida también es un objeto de comando (consulta Salida de /osc/commands/execute
)
Error
Código de error |
Descripción |
missingParameter |
id no se ha especificado. Este parámetro requiere un id. de comando devuelto por una llamada previa a /osc/commands/execute . |
invalidParameterName |
No se reconoce el parámetro de entrada. |
invalidParameterValue |
Se reconoce el parámetro de entrada, pero su valor no es válido; por ejemplo, el valor del id no existe o su tipo es incorrecto. |
Ejemplo |
Solicitud |
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"
} |
Respuesta |
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"
}
} |