狀態

/osc/commands/status API 會傳回先前 inProgress 命令的狀態。 status API 很適合用來輪詢先前所發出命令的進度；例如，判斷 camera.takePicture 是否已完成。

輸入

名稱	類型	描述
`id`	字串	先前呼叫 `/osc/commands/execute` 而傳回的命令 ID。

輸出

輸出也是命令物件（請參閱 /osc/commands/execute 的輸出)

錯誤

錯誤代碼	描述
`missingParameter`	未指定 `id`。此參數需要先前呼叫 `/osc/commands/execute` 而傳回的命令 ID。
`invalidParameterName`	無法辨識輸入參數。
`invalidParameterValue`	辨識出輸入參數，但為無效值；例如，`id` 值不存在或其類型不正確。

範例
要求	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" }
回應	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" } }

範例

要求

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

回應

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