Stan

Interfejs API /osc/commands/status zwraca stan poprzednich poleceń inProgress. Interfejs status API przydaje się do odpytywania postępu wydanego wcześniej polecenia, na przykład do sprawdzania, czy camera.takePicture zostało wykonane.

Dane wejściowe

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

Wyniki

Dane wyjściowe są również obiektem polecenia (patrz Dane wyjściowe funkcji /osc/commands/execute).

Błąd

Kod błędu Opis
missingParameter Nie określono id. 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 został rozpoznany, ale jego wartość jest nieprawidłowa, np. wartość id nie istnieje lub jego 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"
    }
}