Skip to main content
GET
يُنزّل صورة رمز QR مُصيَّرة على مضيف Management API (‏management.scanova.io)، مصادَقًا عليها بمفتاح Management API الخام الخاص بك.
string
مطلوب
qrid الخاص برمز QR، مثل QR7K9M2XN.
متاحة أيضًا عبر /qr/{qrid}/download/ — نفس العرض (view)، ونفس السلوك.

معلمات الاستعلام

string
افتراضي:"png"
صيغة الإخراج: png، jpg، jpeg، svg، pdf، eps، أو ps.
integer
افتراضي:"300"
حجم الصورة بالبكسل، من 10 إلى 2400.
boolean
افتراضي:"false"
عندما تكون true، تعيد ملف PDF جاهزًا للطباعة يُولَّد محليًا (وليس عبر خدمة توليد الصور)، وتتجاهل file.
string
تجاوز اختياري لحمولة مُرمَّزة مسبقًا. رموز QR الديناميكية لا تحتاج إلى هذا — إنه موجود لرموز QR الثابتة، لأن هذه الواجهة الخلفية لا تُعيد إنتاج منطق ترميز بيانات الواجهة الأمامية على جانب العميل بشكل مستقل بالنسبة للأنواع الثابتة.

الاستجابة

الطلب الناجح يعيد الصورة كتنزيل ملف ثنائي (Content-Disposition: attachment)، مع اسم ملف مُشتق من اسم رمز QR (أو qrid الخاص به إذا لم يكن مُسمًّى).

الأخطاء

تُعاد عندما تكون size خارج النطاق 102400، أو عندما لا تكون file واحدة من الصيغ المدعومة.
qrid غير موجود، أو لا ينتمي إلى الحساب الذي يخصه المفتاح.
خدمة توليد الصور المنبع (upstream) غير متاحة. هذا ليس خطأ من جانب العميل — أعد المحاولة، وتواصل مع الدعم إذا استمر.

ذات صلة

التفويضات

Authorization
string
header
مطلوب

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

معلمات المسار

qrid
string
مطلوب

الاستجابة

200

QR image binary