Stato

L'API /osc/commands/status restituisce lo stato dei comandi inProgress precedenti. L'API status è utile per eseguire il polling dell'avanzamento di un comando emesso in precedenza; ad esempio per determinare se camera.takePicture è stato completato.

Input

Nome Tipo Descrizione
id Stringa ID comando restituito da una chiamata precedente a /osc/commands/execute.

Output

L'output è anche un oggetto comando (vedi Output di /osc/commands/execute).

Errore

Codice di errore Descrizione
missingParameter id non è specificato. Questo parametro richiede un ID comando restituito da una precedente chiamata a /osc/commands/execute.
invalidParameterName Il parametro di input non è riconosciuto.
invalidParameterValue Il parametro di input è stato riconosciuto, ma il relativo valore non è valido; ad esempio, il valore id non esiste o il tipo non è corretto.

Esempio
Richiedi 
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"
}
Risposta 
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"
    }
}