Trạng thái

API /osc/commands/status trả về trạng thái cho các lệnh inProgress trước đó. API status rất hữu ích trong việc thăm dò tiến trình của một lệnh đã đưa ra trước đó; chẳng hạn như xác định liệu camera.takePicture đã hoàn tất hay chưa.

Đầu vào

Tên Loại Mô tả
id Chuỗi Mã lệnh được lệnh gọi trước đó trả về cho /osc/commands/execute.

Đầu ra

Kết quả cũng là một đối tượng lệnh (xem phần Đầu ra của /osc/commands/execute)

Lỗi

Mã lỗi Mô tả
missingParameter id chưa được chỉ định. Tham số này yêu cầu mã nhận dạng lệnh do lệnh gọi trước đó trả về cho /osc/commands/execute.
invalidParameterName Không nhận dạng được tham số đầu vào.
invalidParameterValue Tham số đầu vào được nhận dạng, nhưng giá trị của nó không hợp lệ; ví dụ: giá trị id không tồn tại hoặc loại của giá trị không chính xác.

Ví dụ:
Yêu cầu 
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"
}
Đáp 
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"
    }
}