وثائق واجهة برمجة التطبيقات
عمليات بالجملة

إنشاء رموز QR بكميات كبيرة

قم بأتمتة إنشاء رموز QR الخاصة بك باستخدام واجهة برمجة التطبيقات الخاصة بنا. أنشئ مئات أو آلاف رموز QR دفعة واحدة، مثالي للحملات الكبيرة، أو وضع العلامات على المنتجات، أو تتبع الأصول.

استيراد CSV

قم بتحميل ملف CSV يحتوي على بيانات رمز الاستجابة السريعة الخاص بك وسنقوم بإنشائها جميعًا دفعة واحدة.

API دفعة

إنشاء رموز QR متعددة في استدعاء API واحد مع حمولة JSON.

المعالجة غير المتزامنة

تتم عمليات الاستيراد الكبيرة في الخلفية مع تتبع الحالة.

نقاط النهاية

طريقةنقطة النهايةوصف
POST
/organizations/:orgId/qr-codes/bulk-importابدأ استيرادًا جماعيًا من CSV
GET
/organizations/:orgId/qr-codes/bulk-importقائمة بجميع وظائف الاستيراد
GET
/organizations/:orgId/qr-codes/bulk-import/:idاحصل على حالة وظيفة الاستيراد
GET
/organizations/:orgId/qr-codes/bulk-import/sampleتحميل قالب CSV
POST
/organizations/:orgId/qr-codes/batch/updateتحديث دفعة متعددة من رموز QR
POST
/organizations/:orgId/qr-codes/batch/cloneاستنساخ رموز QR متعددة
DELETE
/organizations/:orgId/qr-codes/batchحذف رموز QR متعددة

استيراد دفعة CSV

أسهل طريقة لإنشاء العديد من رموز QR دفعة واحدة هي عبر استيراد CSV. اتبع هذه الخطوات:

1

قم بتنزيل قالب CSV

احصل على القالب لنوع رمز الاستجابة السريعة الخاص بك لضمان التنسيق الصحيح.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv
2

املأ بياناتك

أضف بيانات رمز الاستجابة السريعة الخاص بك إلى ملف CSV. إليك مثال على رموز QR الخاصة بالروابط:

url_qr_codes.csv
name,url,folder,tags
Homepage QR,https://example.com,Marketing,homepage;main
Product Page,https://example.com/product,Products,product;featured
Contact Us,https://example.com/contact,Marketing,contact;support
Promo Landing,https://example.com/promo,Campaigns,promo;summer2024
3

قم بتحميل ملف CSV

أرسل الملف لبدء وظيفة الاستيراد.

ابدأ الاستيراد
curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@url_qr_codes.csv" \
  -F "type=URL"
4

راقب تقدم الاستيراد

تحقق من حالة وظيفة الاستيراد الخاصة بك.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/import_abc123" \
  -H "X-API-Key: YOUR_API_KEY"
استجابة
{
  "id": "import_abc123",
  "status": "COMPLETED",
  "type": "URL",
  "totalRows": 100,
  "processedRows": 100,
  "successCount": 98,
  "errorCount": 2,
  "errors": [
    { "row": 45, "error": "Invalid URL format" },
    { "row": 72, "error": "Name is required" }
  ],
  "createdAt": "2024-01-15T10:00:00Z",
  "completedAt": "2024-01-15T10:02:30Z"
}

مرجع عمود CSV

يتطلب كل نوع من أنواع رموز QR أعمدة مختلفة. فيما يلي الأكثر شيوعًا:

رموز QR للروابط

عمودمطلوبوصف
name
مطلوب
اسم العرض لرمز الاستجابة السريعة
url
مطلوب
رابط الوجهة (يجب أن يبدأ بـ http:// أو https://)
folder
اختياري
اسم المجلد لتنظيم رمز الاستجابة السريعة
tags
اختياري
علامات مفصولة بفواصل منقوطة

رموز QR لبطاقات vCard

عمودمطلوبوصف
name
مطلوب
اسم العرض لرمز الاستجابة السريعة
firstName
مطلوب
اسم الاتصال الأول
lastName
مطلوب
اسم عائلة جهة الاتصال
email
اختياري
عنوان البريد الإلكتروني
phone
اختياري
رقم الهاتف
company
اختياري
اسم الشركة
title
اختياري
عنوان الوظيفة

تحديث دفعة

قم بتحديث عدة رموز QR دفعة واحدة من خلال استدعاء API واحد.

POST
/organizations/:orgId/qr-codes/batch/update
طلب تحديث دفعي
curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/batch/update" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["qr_abc123", "qr_def456", "qr_ghi789"],
    "updates": {
      "folderId": "folder_xyz",
      "style": {
        "foregroundColor": "#1D59F9"
      }
    }
  }'

حدود الاستيراد

الحد الأقصى من الصفوف

10,000

رموز QR في ملف CSV

حد حجم الملف

10 MB

أقصى حجم لملف CSV

نصيحة: بالنسبة للاستيرادات الكبيرة جدًا (أكثر من 10,000 رمز QR)، يُفضل تقسيم ملف CSV الخاص بك إلى عدة ملفات واستيرادها بشكل متسلسل.

حالات الاستخدام

تسمية المنتج

قم بإنشاء رموز QR فريدة لكل منتج في مخزونك

حملات التسويق

إنشاء رموز QR مخصصة لكل مستلم

تتبع الأصول

وسم المعدات أو الوثائق أو الأصول المادية

إدارة الفعاليات

إنشاء تذاكر أو شارات مع رموز QR فريدة

الخطوات التالية

تعرف على الميزات ذات الصلة: