สถานะ

/osc/commands/status API จะแสดงสถานะสําหรับคําสั่ง inProgress ก่อนหน้า status API มีประโยชน์ในการสํารวจความคืบหน้าของคําสั่งที่ออกก่อนหน้านี้ เช่น ใช้ในการกำหนดว่า camera.takePicture ทำงานเสร็จสมบูรณ์แล้วหรือไม่

อินพุต

ชื่อ Type คำอธิบาย
id สตริง รหัสคำสั่งที่การเรียกก่อนหน้านี้ไปยัง /osc/commands/execute แสดงผล

เอาต์พุต

เอาต์พุตจะเป็นออบเจ็กต์คำสั่งด้วย (ดูเอาต์พุตของ /osc/commands/execute)

ข้อผิดพลาด

รหัสข้อผิดพลาด คำอธิบาย
missingParameter ไม่ได้ระบุ id พารามิเตอร์นี้ต้องใช้รหัสคำสั่งที่แสดงผลโดยการเรียกไปยัง /osc/commands/execute ก่อนหน้านี้
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"
    }
}