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