דף זה תורגם על ידי Cloud Translation API.

סטטוס

ה-API /osc/commands/status מחזיר את הסטטוס של פקודות inProgress הקודמות. ה-API של status שימושי לדגום את ההתקדמות של פקודה שהונפקה בעבר. לדוגמה, קביעה אם camera.takePicture השלים.

קלט

שם	סוג	תיאור
`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" } }

דוגמה

שליחת בקשה

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