curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
العمليات بالجملة
إنشاء نطاق تسلسلي GS1 بالجملة
POST /bulk-operation/gs1/serial-range-generate/
POST
/
bulk-operation
/
gs1
/
serial-range-generate
/
curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
ينشئ نطاقًا متسلسلًا من رموز QR الخاصة بـ GS1 انطلاقًا من رقم تسلسلي بداية، بشكل غير متزامن، على مضيف Management API (
نفس النمط غير المتزامن كما في إنشاء رموز QR بالجملة — استطلع سرد العمليات بالجملة. يُتحقَّق من مخطط أول حمولة GS1 مُجمَّعة في النطاق قبل إنشاء أي رموز QR، لذا فإن شكل
api.scanova.io)، مع المصادقة باستخدام مفتاح Management API الخام الخاص بك.
POST https://api.scanova.io/bulk-operation/gs1/serial-range-generate/
Authorization: YOUR_API_KEY
لا يوجد رفع ملف — تُنشئ نقطة النهاية هذه النطاق برمجيًا من
start_serial وcount.string
مطلوب
تسمية لهذه العملية.
string
مطلوب
الرقم التسلسلي الأول في النطاق، أرقام فقط، بحد أقصى 20 حرفًا.
integer
مطلوب
عدد الأرقام التسلسلية المتتالية المراد إنشاؤها، بحد أدنى 1.
string
معرّف رمز QR موجود من نوع GS1 يُنسخ منه قيم الحقول المشتركة. قدّم هذا أو
shared_info، وليس كلاهما غائبًا.array
قيم حقول GS1 المشتركة بين كل رقم تسلسلي في النطاق، بصيغة JSON. قدّم هذا أو
sample_qrid، وليس كلاهما غائبًا.integer
معرّف نطاق مخصص يُستخدم للروابط القصيرة لرموز QR المُنشأة.
string
بيانات نمط التصميم المطبّقة على جميع رموز QR المُنشأة.
object
قاعدة اختيارية لإلغاء التنشيط التلقائي تُطبَّق على جميع رموز QR المُنشأة.
object
معاملات تتبّع UTM المطبّقة على روابط جميع رموز QR المُنشأة.
integer
معرّف مجلد لحفظ رموز QR المُنشأة فيه.
curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
shared_info المُشوَّه يفشل بسرعة.
يُعاد 400 إذا تجاوز الرقم التسلسلي الناتج 20 حرفًا في أي نقطة من النطاق، أو إذا لم يُقدَّم أي من shared_info أو sample_qrid، أو إذا تم تجاوز الحصة (BULK_OPERATION أو TOTAL_QR_CODES، مُتحقَّق منها مقابل count الكامل). يُعاد 403 إذا كان الحساب يفتقر إلى حصة BULK_OPERATION، أو كانت خطته غير مفعّلة، أو يفتقر إلى صلاحية BULK_OPERATION_CAN_GENERATE.
ذات صلة
- إنشاء رموز QR بالجملة — النظير العام القائم على الملفات لفئات غير GS1.
- سرد العمليات بالجملة — انتظار الاكتمال.
- نظرة عامة على 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: YOUR_API_KEY. 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.
هل كانت هذه الصفحة مفيدة؟