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