curl -X POST "https://api.scanova.io/bulk-operation/generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "name=September event QR batch" \
-F "file=@event-qrs.xlsx" \
-F 'auto_deactivate={"expire_on":"2026-12-31T23:59:59Z"}'
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
العمليات بالجملة
إنشاء رموز QR بالجملة
POST /bulk-operation/generate/
POST
/
bulk-operation
/
generate
/
curl -X POST "https://api.scanova.io/bulk-operation/generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "name=September event QR batch" \
-F "file=@event-qrs.xlsx" \
-F 'auto_deactivate={"expire_on":"2026-12-31T23:59:59Z"}'
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
ينشئ رموز QR عديدة من جدول بيانات تم رفعه، بشكل غير متزامن، على مضيف Management API (
api.scanova.io)، مع المصادقة باستخدام مفتاح Management API الخام الخاص بك.
POST https://api.scanova.io/bulk-operation/generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
مطلوب
تسمية لهذه العملية، تظهر في سرد العمليات بالجملة.
file
مطلوب
الجدول المملوء، صف واحد لكل رمز QR. يوفّر عمود
qr code id في الصف الأول رمز QR القالب — تُقارَن فئته ومخطط حقوله مع كل صف آخر أثناء التحقق.integer
معرّف نطاق مخصص يُستخدم للروابط القصيرة لرموز QR المُنشأة.
string
بيانات نمط التصميم المطبّقة على جميع رموز QR المُنشأة، عادةً مُرمَّزة كسلسلة JSON.
object
قاعدة اختيارية لإلغاء التنشيط التلقائي تُطبَّق على جميع رموز QR المُنشأة:
expire_on/activate_on (تواريخ وأوقات مستقبلية بصيغة ISO-8601) و/أو expire_on_scan_count (عدد صحيح موجب).integer
معرّف مجلد لحفظ رموز QR المُنشأة فيه.
curl -X POST "https://api.scanova.io/bulk-operation/generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "name=September event QR batch" \
-F "file=@event-qrs.xlsx" \
-F 'auto_deactivate={"expire_on":"2026-12-31T23:59:59Z"}'
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
هذا إجراء غير متزامن
تؤكد استجابة200 أن المهمة قُبِلت، وليس أن رموز QR موجودة بالفعل — إذ يُنفَّذ العمل الفعلي على عامل خلفي. استطلع سرد العمليات بالجملة (بالتصفية محليًا حسب operation_id) وراقب status (new ← completed/partially_completed/failed) وprogress، ثم اقرأ result_file/log_file عند الاكتمال. كما يتلقى الحساب إشعارًا بالبريد الإلكتروني عند الاكتمال.
يُعاد 400 بسبب ملف/أعمدة غير صالحة، أو رمز QR قالب مفقود أو غير صالح، أو تجاوز الحصة (BULK_OPERATION أو TOTAL_QR_CODES). يُعاد 403 إذا كان الحساب يفتقر إلى حصة BULK_OPERATION، أو كانت خطته غير مفعّلة، أو يفتقر إلى صلاحية BULK_OPERATION_CAN_GENERATE.
ذات صلة
- إنشاء رموز QR بالجملة (قوالب v2) — النظير لقوالب v2.
- التحقق من صحة ملف عملية بالجملة — التحقق من الملف قبل استهلاك هذا الاستدعاء.
- تنزيل ملف نموذجي — من أين تبدأ الجدول.
- سرد العمليات بالجملة — انتظار الاكتمال.
- نظرة عامة على Management API — مخطط المصادقة وقواعد الحصة المطبّقة على نقطة النهاية هذه.
التفويضات
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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
Generation started.
هل كانت هذه الصفحة مفيدة؟