تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الحالة

تعرض واجهة برمجة التطبيقات /osc/commands/status حالة أوامر inProgress السابقة. تكون واجهة برمجة التطبيقات 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"
    }
}