Qivo الدليل العملي
كيف يعمل API توليد الرمز QR
يتيح لك API توليد رموز QR تلقائيًا من موقع الويب الخاص بك أو أداة داخلية أو سكريبت.
تطبيقك يرسل المحتوى والإعدادات؛ Qivo يعيد صورة QR ثابتة.
من المحرر اليدوي إلى التكامل
في المحرر ، يملأ الشخص الحقول ويقوم بالضغط على التنزيل.مع API ، يقوم البرنامج بهذه الإجراءات ، على سبيل المثال ، توليد رمز QR صفحة المنتج أثناء إعداد ملصق.
لا يجعل مكالمة API رمزًا ديناميكيًا.تخزين الصورة البيانات المقدمة بدلاً من عنوان URL Qivo الوسطى.يمكنك حفظ واستخدام الملف دون الاتصال بالمولد مرة أخرى.
ماذا يحتوي الطلب على
يحتوي طلب GET على عنوان الخدمة والمعلمات ومفتاح سري.المحتوىمعدل النوع يختار نوع البيانات، ويختار النموذج PNG أو SVG، ويسيطر الشكل والحدود والمركز على التصميم.
يجب أن تكون قيم المعلمات رمز URL.استخدم الأدوات القياسية لغتك للتعامل بشكل صحيح مع المساحات، + في أرقام الهاتف و # في الألوان.تسبب الحقول المطلوبة غير صالحة أو مفقودة استجابة خطأ.
لماذا ينتمي المفتاح إلى خادمك
المفتاح يمنح الوصول إلى الجيل.يمكن للزوار قراءة مفتاح يضع في جافا سكريبت الصفحة العامة.إرسال طلبات من خادمك وتحميل المفتاح من متغير البيئة.
إرسال المفتاح في عنوان X-API-Key عبر HTTPS. يتم دعم معيار URL المفتاح أيضًا ، ولكن يمكن أن تظهر عناوين URL في التاريخ والمجلدات. لا تضع مفتاحك السري في صورة QR أو الأمثلة العامة.
كيفية التعامل مع الاستجابة
إجابة ناجحة تحتوي على الصورة نفسها ، وليس JSON مع رابط تنزيل.تحقق من حالة HTTP قبل حفظها.تعود الأخطاء إلى JSON مع تفسير ؛ لا تخزن ذلك كـ PNG.
SVG مفيد للمواد المطبوعة، في حين أن PNG تناسب الصور اليومية. تجنب تجديد الرمز في كل زيارة إلى صفحة غير متغيرة: حفظ وإعادة استخدام الملف.
ما يجب التحقق منه قبل نشره
يصدق API الإدخال ولكن لا يخفف الصورة النهائية.هذا يقلل من المعالجة، ولكن تدفق العمل الخاص بك يجب أن تتعامل مع اختبارات الفحص.اختبار مزيج التصميم النموذجي وأكبر حجم البيانات التي تتوقعها.
اترك منطقة هادئة خفيفة من أربعة وحدات على الأقل، والتباين الجيد وحجم كاف. فحص التخطيط المطبوع النهائي مع الهاتف. تحتوي صفحة API على المعلمات الفنية ومثال جاهز للاستخدام PHP و JavaScript و Python و cURL.
المصادر والمزيد من القراءة
تم إعدادها وصيانتها بواسطة Umind. اختبر هذه التوصيات على التصميم النهائي والأجهزة المستهدفة.