Stan

Interfejs /osc/commands/status API zwraca stan poprzednich poleceń inProgress. Interfejs API status przydaje się do ankietowania postępu wykonanego wcześniej polecenia. np. ustalenie, czy zadanie camera.takePicture zostało ukończone.

Dane wejściowe

Nazwa Typ Opis
id Ciąg znaków Identyfikator polecenia zwrócony przez poprzednie wywołanie /osc/commands/execute.

Wyniki

Dane wyjściowe są też obiektem poleceń (patrz Dane wyjściowe w tabeli /osc/commands/execute).

Błąd

Kod błędu Opis
missingParameter Element id nie został określony. Ten parametr wymaga identyfikatora polecenia zwróconego przez poprzednie wywołanie funkcji /osc/commands/execute.
invalidParameterName Nie rozpoznano parametru wejściowego.
invalidParameterValue Parametr wejściowy jest rozpoznawany, ale jego wartość jest nieprawidłowa. np. wartość id nie istnieje lub jej typ jest nieprawidłowy.

Przykład

Wyślij prośbę
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"
}
Odpowiedź
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"
    }
}