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