تعرض واجهة برمجة التطبيقات /osc/commands/status
حالة أوامر inProgress
السابقة. ويمكن الاستفادة من واجهة برمجة التطبيقات status
في استطلاع مستوى تقدُّم أمر تم إصداره سابقًا، مثل تحديد ما إذا كان قد تم إكمال 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"
}
} |