لعرض صورة كاملة الحجم أو تم تغيير حجمها وفقًا لعنوان URI الخاص بها. تشمل معلَمات الإدخال
الحل. هذا هو الأمر الوحيد الذي يجب عرضه، وهو Content-Type: image/jpeg.
تعرض جميع الأوامر الأخرى Content-Type: application/json;charset=utf-8.
تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات.
المعلمات
- fileUri: معرّف الموارد المنتظم (URI) للملف المستهدف. تقرر الشركات المصنِّعة ما إذا كانت ستستخدم معرفات الموارد المنتظمة (URI) المطلقة أو النسبية. وقد يتعامل العملاء مع هذا المعرّف على أنّه معرّف مبهم.
- maxSize: (اختيارية) أقصى حجم للصورة المطلوبة
max(scaledimage_width, scaledimage_height). في حال إسقاط
maxSizeأو تكبيره عن الصورة بالحجم الكامل، يتم عرض الصورة بالحجم الكامل.
النتائج
- content: البيانات الثنائية للصور، بما في ذلك البيانات المقابلة (على سبيل المثال، البيانات المعدّلة) البيانات الوصفية في رأس الصورة.
الأخطاء
- مَعلمة مفقودة: لم يتم تحديد قيمة "
fileUri" المطلوبة. - spamparamName: لم يتم التعرُّف على اسم مَعلمة إدخال.
- invalidParameterValue: يتم التعرّف على اسم مَعلمة الإدخال، ولكن قيمته.
غير صالح؛ على سبيل المثال، قيمة
fileUriغير موجودة، ونوع بياناته غير صحيح، أوmaxSizeتحتوي على نوع بيانات غير صحيح.
مفتاح Command I/O | |
|---|---|
| إدخال الطلب | {
"parameters": {
"fileUri": "file URI",
"maxSize": 400
}
} |
| مخرجات الأوامر | Image binary data |
| مخرجات الأوامر (خطأ) | {
"error": {
"code": "invalidParameterValue",
"message": "Parameter fileUri doesn't exist."
}
} |