Status

Mit der API /osc/commands/status wird der Status vorheriger Befehle inProgress zurückgegeben. Die API status ist hilfreich, um den Fortschritt eines zuvor ausgegebenen Befehls abzurufen, um z. B. zu ermitteln, ob camera.takePicture abgeschlossen wurde.

Eingabe

Name Typ Beschreibung
id Zeichenfolge Befehls-ID, die von einem vorherigen Aufruf von /osc/commands/execute zurückgegeben wurde.

Ausgabe

Die Ausgabe ist außerdem ein Befehlsobjekt (siehe Ausgabe von /osc/commands/execute)

Fehler

Fehlercode Beschreibung
missingParameter Die id ist nicht angegeben. Dieser Parameter erfordert eine Befehls-ID, die von einem vorherigen Aufruf von /osc/commands/execute zurückgegeben wurde.
invalidParameterName Der Eingabeparameter ist unbekannt.
invalidParameterValue Der Eingabeparameter ist bekannt, sein Wert ist jedoch unzulässig; beispielsweise existiert der Wert für die id nicht, oder der ID-Typ ist ungültig.

Beispiel
Anforderung 
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"
}
Antwort 
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"
    }
}