Status

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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