Skip to main content

واجهة برمجة تطبيقات رمز QR - إنشاء رموز QR برمجياً

ادمج إنشاء رموز QR في تطبيقك أو لوحة تحكم SaaS أو الواجهة الخلفية للجوال أو سير عمل التجارة الإلكترونية أو حزمة أتمتة التسويق باستخدام واجهة REST API من QR-Build. أرسل معاملات JSON، واستلم مخرجات PNG أو SVG أو base64 JSON، وأدر وجهات QR الديناميكية دون الحاجة إلى إعادة بناء نظام إنشاء رموز QR بنفسك.

الموقع الإلكتروني

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

1 / 21
واجهة برمجة تطبيقات رمز QR هي نقطة نهاية REST تقبل معاملات مثل URL الوجهة وتنسيق المخرجات وحجم الصورة ونوع رمز QR، ثم تعيد صورة رمز QR أو كائن بيانات. يستخدم المطورون واجهات برمجة تطبيقات رموز QR لإنشاء رموز QR برمجياً داخل التطبيقات بدلاً من إنشاء كل رمز يدوياً.

ما هي واجهة برمجة تطبيقات رمز QR؟

واجهة برمجة تطبيقات رمز QR هي نقطة نهاية REST تقبل معاملات مثل URL الوجهة وتنسيق المخرجات وحجم الصورة، وتعيد رمز QR بصيغة PNG أو SVG أو كائن JSON مشفر بـ base64. يستخدم المطورون واجهات برمجة تطبيقات رموز QR لإنشاء رموز QR برمجياً داخل التطبيقات، دون الحاجة إلى بناء أو صيانة مكتبة QR بأنفسهم.

واجهة REST API هي واجهة مبنية على HTTP تتبع اصطلاحات الطلب والاستجابة القياسية. في واجهة برمجة تطبيقات رمز QR، نقطة النهاية هي URL المحدد الذي يستدعيه تطبيقك، مثل POST /v1/qr، ويحتوي نص الطلب على معاملات QR مثل النوع والبيانات والتنسيق والحجم واللون وما إذا كان الرمز ثابتاً أم ديناميكياً.

يختار المطورون واجهة API عندما يحتاج إنشاء رموز QR إلى الحدوث داخل سير عمل المنتج: مستخدم SaaS ينقر على إنشاء، أو كتالوج تجارة إلكترونية يستورد 5000 وحدة SKU، أو تطبيق جوال يطلب رمزاً قابلاً للمشاركة، أو حملة CRM تنشئ أصول QR قابلة للتتبع بعد محفز الحدث.

يدعم QR-Build كلاً من رموز QR الثابتة والديناميكية. يخزن رمز QR الثابت الوجهة النهائية مباشرة في صورة QR. يخزن رمز QR الديناميكي طبقة إعادة توجيه مُدارة من QR-Build، مما يتيح تعديل الوجهة وتحليلات المسح بعد طباعة رمز QR أو توزيعه.

كيف تُنشئ رمز QR باستخدام QR-Build API؟

لإنشاء رمز QR عبر API، أرسل طلب POST مصادقاً إلى نقطة نهاية الإنشاء مع المعاملات المطلوبة: URL والتنسيق والحجم ونوع QR. يستجيب API بصورة رمز QR أو كائن JSON يحتوي على بيانات الصورة، ومعظم التطبيقات الأساسية مكتملة في أقل من 10 أسطر من الكود.

تم تصميم QR-Build API للتكامل من جانب الخادم. إذا كنت تفضل سير العمل اليدوي أولاً، راجع كيفية إنشاء رمز QR في واجهة المستخدم على الويب، ثم استخدم API عندما يحتاج الإنشاء إلى التشغيل من الكود.

  1. 1 المصادقة بمفتاح API الخاص بك. مفتاح API هو سلسلة بيانات اعتماد فريدة تُعرّف حسابك في QR-Build وتفوّض كل طلب.
  2. 2 إرسال طلب POST. أرسل معاملات JSON إلى نقطة نهاية الإنشاء، بما في ذلك نوع QR وبيانات الوجهة وتنسيق الصورة والحجم.
  3. 3 استلام رمز QR. يمكن أن يعيد الرد URL لصورة PNG أو ترميز SVG أو حمولة JSON بصيغة base64 اعتماداً على تنسيق المخرجات المطلوب.
  4. 4 تحديث الوجهات الديناميكية عند الحاجة. بالنسبة لرموز QR الديناميكية، أرسل طلب PATCH لتغيير وجهة إعادة التوجيه دون الحاجة إلى إعادة إنشاء صورة QR المطبوعة.
  5. 5 استرداد التحليلات عندما يكون رمز QR ديناميكياً. استخدم نقطة نهاية GET للتحليلات لسحب عدد المسح والطوابع الزمنية والموقع وتفاصيل الأجهزة إلى لوحة التحكم الخاصة بك.

مثال على طلب POST

curl -X POST https://api.qr-build.com/v1/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"url","data":"https://example.com","format":"png","size":300}'

مثال على استجابة JSON

{
  "id": "qr_8x4m2p",
  "type": "url",
  "format": "png",
  "static": true,
  "imageUrl": "https://cdn.qr-build.com/qr/qr_8x4m2p.png",
  "createdAt": "2026-07-01T12:00:00Z"
}

ما تنسيقات الطلب والاستجابة لـ API المدعومة؟

تدعم واجهات برمجة تطبيقات رموز QR عادةً PNG للطباعة والبريد الإلكتروني، وSVG لعرض الويب القابل للتوسع، وJSON المشفر بـ base64 للتضمين المباشر. PNG بدقة ثابتة، SVG يبقى حاداً بأي حجم، وbase64 يتجنب طلب ملف صورة منفصل.

اختر تنسيق الاستجابة بناءً على مكان عرض رمز QR وكيفية تخزينه وما إذا كانت الأنظمة اللاحقة تحتاج إلى بيانات وصفية. نقيّم التنسيقات بناءً على سلوك DPI وحجم الملف ودعم المتصفح وعدد رحلات HTTP.

تنسيقات المخرجات المدعومة

التنسيقالأفضل لـملاحظات
PNG الطباعة والبريد الإلكتروني والتضمين السريع صورة نقطية بدقة ثابتة؛ اطلب حجماً أكبر للطباعة والتغليف.
SVG تطبيقات الويب وواجهات UI القابلة للتوسع وشاشات HiDPI تنسيق متجه يبقى حاداً بأي حجم ومثالي للوحات التحكم التكيفية.
Base64 HTML المضمّن وملفات PDF وسير العمل بدون ملفات يضمّن بيانات الصورة في JSON أو HTML دون URL صورة عامة منفصلة.
JSON المعالجة البرمجية وتخزين البيانات الوصفية يعيد المعرفات وبيانات الصورة والوجهة والتنسيق والبيانات الوصفية للإنشاء في استجابة واحدة.

أنواع QR المدعومة عبر API

اعتباراً من عام 2026، يدعم QR-Build API 12 نوعاً من رموز QR. للاطلاع على دليل مفاهيمي أشمل، راجع نظرتنا العامة على أنواع رموز QR.

URL / رابط

أنشئ رمز QR يفتح صفحة ويب أو صفحة هبوط أو مقالة دعم أو رابطاً عميقاً للتطبيق.

WiFi

شفّر اسم الشبكة وكلمة المرور ونوع الأمان حتى يتمكن المستخدمون من الانضمام إلى شبكة بعد المسح.

vCard

أنشئ رموز QR للتواصل تحتوي على الاسم والهاتف والبريد الإلكتروني والشركة والمسمى الوظيفي وحقول الموقع الإلكتروني.

PDF

وجّه المستخدمين إلى الأدلة والقوائم والكتيبات ووثائق الامتثال أو الملفات القابلة للتنزيل.

بريد إلكتروني

افتح بريداً إلكترونياً مملوءاً مسبقاً بحقول المستلم والموضوع والنص.

هاتف

أنشئ رموز QR للاتصال الفوري لمكاتب الخدمة وفرق المبيعات وبطاقات الدعم.

قائمة

أنشئ رموز QR لقوائم المطاعم وصفحات القوائم الموسمية ومواضع الطاولات.

قسيمة

أنشئ رموز QR ترويجية للخصومات وصفحات الاسترداد وعروض الحملات.

عملة مشفرة

شفّر عناوين المحافظ وبيانات الدفع الوصفية لتدفقات العملات المشفرة المدعومة.

PayPal

أنشئ رموز QR للدفع توجّه إلى وجهات دفع أو تبرع عبر PayPal.

تقويم

أنشئ رموز QR لتفاصيل الفعاليات وتذكيرات المواعيد ودعوات التقويم.

جماعي

أنشئ رموز QR متعددة من طلب دفعة واحدة للكتالوجات والتذاكر والملصقات وعمليات الطباعة.

رموز QR الثابتة مقابل الديناميكية عبر API

رمز QR الثابت المُنشأ عبر API يشفّر URL الوجهة مباشرة في الصورة، لذلك لا يمكن تغييره بعد الإنشاء. رمز QR الديناميكي يشفّر URL إعادة توجيه مُداراً من الخادم، لذلك يمكن تحديث الوجهة النهائية لاحقاً عبر طلب PATCH دون الحاجة إلى إعادة طباعة رمز QR.

الاختيار بين الثابت والديناميكي هو قرار معماري. استخدم رموز QR الثابتة للوجهات الثابتة ورموز QR الديناميكية عندما قد تحتاج الحملات أو المنتجات أو الملصقات أو الأصول المطبوعة إلى تعديلات أو تحليلات. تعلّم كيف تختلف رموز QR الثابتة مقابل الديناميكية خارج سياق API.

الميزةQR الثابت عبر APIQR الديناميكي عبر API
الوجهة قابلة للتعديل لا نعم
تحليلات المسح لا نعم
URL في حمولة QR URL نهائي مباشر طبقة إعادة توجيه QR-Build
الأفضل لـ الأصول الثابتة والروابط الدائمة الحملات والمنتجات والتغليف والمواد المطبوعة
طريقة تحديث الوجهة إعادة الإنشاء وإعادة الطباعة PATCH لنقطة نهاية الإدارة
الخطة المناسبة الاختبار المجاني والاستخدام الثابت الخطط المدفوعة للتحليلات والإدارة ذات الحجم الأعلى

ملاحظة منهجية: هذه المقارنة مبنية على سلوك QR-Build API. تحقق دائماً من توفر الميزات وحدود المعدل ومتطلبات الخطة مع مزود QR الخاص بك قبل النشر في الإنتاج.

حالات الاستخدام لتكامل واجهة برمجة تطبيقات رمز QR

تكاملات واجهة برمجة تطبيقات رمز QR هي الأفضل عندما يكون إنشاء QR جزءاً من نظام آخر: كتالوجات المنتجات أو لوحات تحكم SaaS أو تطبيقات الجوال أو أتمتة التسويق أو سير عمل الفعاليات أو إنشاء المستندات. تُزيل API إنشاء QR اليدوي من سير العمل المتكررة.

هذه هي أنماط التكامل التي تكون فيها واجهة API من QR-Build أكثر فائدة من المولّد اليدوي.

1

التجارة الإلكترونية - رموز QR لكل منتج على نطاق واسع

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

2

منتجات SaaS - إنشاء QR مضمّن

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

3

أتمتة التسويق - رموز QR للحملات

شغّل إنشاء QR من CRM أو CDP أو البريد الإلكتروني أو أحداث الحملات. رموز QR الديناميكية تتيح للمسوّقين تحديث الوجهات في منتصف الحملة مع إبقاء الأصول المطبوعة نشطة.

4

تطبيقات الجوال - استدعاءات API خفيفة الوزن

يمكن لتطبيقات iOS وAndroid طلب صور QR من خلال واجهة خلفية من جانب الخادم، ثم عرض URL الصورة أو حمولة base64 في التطبيق دون كشف مفتاح API.

5

طباعة المستندات والملصقات

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

راجع رموز QR لإدارة المخزون

API مقابل مولّد QR اليدوي - متى تستخدم كلاً منهما؟

استخدم واجهة برمجة تطبيقات رمز QR عندما تحتاج إلى إنشاء رموز QR على نطاق واسع أو تشغيل الإنشاء من الكود أو تضمين وظيفة QR مباشرة داخل منتجك. المولّدات اليدوية لرموز QR هي الأفضل لرموز QR المفردة العرضية التي لا تحتاج إلى أتمتة أو تكامل.

مولّد QR-Build رموز QR هو الأداة المناسبة للإنشاء اليدوي. API هو الأداة المناسبة عندما يجب أن يعمل إنشاء QR من سير عمل المنتج أو وظيفة الواجهة الخلفية أو خط أنابيب الأتمتة.

السيناريواستخدم APIاستخدم المولّد اليدوي
رمز QR منفرد لنشرة إعلانية الأنسب
إنشاء أكثر من 500 رمز QR للمنتجات الأنسب
رموز QR مضمّنة في لوحة تحكم SaaS الأنسب
QR للحملة بوجهة قابلة للتحديث الأنسب
رمز QR سريع لـ WiFi في المكتب الأنسب
إنشاء QR في الوقت الفعلي بعد إجراء المستخدم الأنسب

مصادقة مفتاح API والأمان

يستخدم QR-Build API مصادقة مفتاح API من خلال رأس Authorization، وليس مفاتيح API في URLs. احتفظ بالمفاتيح في جانب الخادم وخزّنها في متغيرات البيئة وقم بتدوير المفاتيح المخترقة وتحقق من حدود المعدل الحالية في صفحة الأسعار قبل النشر في الإنتاج.

مفتاح API مرتبط بنطاق الحساب ويجب إرساله كرمز Bearer في رأس Authorization. لا تضع مفاتيح API في سلاسل الاستعلام أو JavaScript للمتصفح أو ثنائيات تطبيقات الجوال أو المستودعات العامة أو سجلات التحليلات.

شغّل استدعاءات إنشاء QR من الواجهة الخلفية أو وظيفة serverless أو خدمة التكامل الموثوقة. يجب على تطبيقات جانب العميل استدعاء خادمك، ويجب على خادمك استدعاء QR-Build. هذا يمنع المستخدمين من استخراج المفتاح واستهلاك حصتك.

تحديد المعدل هو حد مفروض من الخادم على الطلبات لكل نافذة زمنية، وتفاصيل الخطة يمكن أن تتغير مع تطور المنتجات. راجع صفحة الأسعار الحالية قبل الإطلاق في الإنتاج بدلاً من الاعتماد على حدود منسوخة في منشور مدونة أو تذكرة تنفيذ.

يفرض QR-Build HTTPS لحركة مرور API. بالنسبة لرموز QR الديناميكية، تخزّن صورة QR طبقة إعادة التوجيه وليس URL الوجهة النهائية؛ تحدث تغييرات الوجهة من خلال طلبات إدارة مصادق عليها.

أمثلة الكود لواجهة برمجة تطبيقات رمز QR

أسرع تكامل لواجهة برمجة تطبيقات رمز QR هو طلب POST من جانب الخادم مع رأس Authorization ونص JSON. تُظهر الأمثلة أدناه curl وJavaScript مع fetch وطلب PATCH لتحديث وجهة QR الديناميكي.

ملاحظة منهجية: الأمثلة أدناه تستخدم نفس سطح API الذي يستخدمه مولّد QR-Build على الويب - لا طبقة API منفصلة. استبدل المفاتيح والمعرفات النائبة بقيم من حسابك قبل الاختبار.

إنشاء رمز QR لـ URL (curl)

curl -X POST https://api.qr-build.com/v1/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"url","data":"https://example.com","format":"png","size":300}'

إنشاء رمز QR لـ URL (JavaScript / Node.js)

const response = await fetch("https://api.qr-build.com/v1/qr", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.QR_BUILD_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    type: "url",
    data: "https://example.com",
    format: "svg",
    size: 300
  })
});

if (!response.ok) {
  throw new Error(`QR generation failed: ${response.status}`);
}

const qr = await response.json();
console.log(qr.imageUrl);

تحديث وجهة QR ديناميكي

curl -X PATCH https://api.qr-build.com/v1/qr/qr_8x4m2p \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"https://example.com/new-campaign"}'

كيف يعمل الإنشاء الجماعي لرموز QR عبر API؟

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

تم تصميم الإنشاء الجماعي لكتالوجات المنتجات وتذاكر الفعاليات وملصقات التغليف وعلامات المخزون وعمليات الطباعة وسير عمل الوكالات حيث تشترك رموز QR الكثيرة في نمط مشترك لكنها تختلف بالوجهة أو البيانات الوصفية.

يتضمن طلب الجماعي النموذجي مصفوفة من الصفوف، كل منها يحتوي على النوع والبيانات والتنسيق والحجم وبيانات التسمية الوصفية الاختيارية. يمكن أن تعيد الاستجابة معرّف وظيفة للمعالجة غير المتزامنة أو URL ملف ZIP أو مصفوفة JSON من أصول QR المُنشأة اعتماداً على حجم الدفعة وإعدادات الحساب.

بالنسبة للوظائف ذات الحجم الكبير، تعامل مع حدود المعدل كجزء من تصميم التكامل. ضع الدفعات في قائمة انتظار وأعد المحاولة بأمان بعد استجابات حد المعدل، وتجنب إعادة إنشاء صور QR الثابتة عندما يكون الأصل المخزن مؤقتاً لا يزال صالحاً.

هل يمكنك الوصول إلى تحليلات المسح عبر API؟

عبر نقطة نهاية GET للتحليلات، يمكنك استرداد عدد المسح وطوابع زمنية المسح وتفاصيل نوع الجهاز وبيانات الموقع الجغرافي لكل رمز QR ديناميكي. يمكن توجيه هذه البيانات إلى لوحات التحكم أو مستودعات البيانات أو أدوات BI لتحليل أداء الحملة.

تُجمع تحليلات المسح عندما يمر رمز QR الديناميكي عبر طبقة إعادة توجيه QR-Build. لا تمر رموز QR الثابتة عبر طبقة إعادة توجيه، لذلك لا يمكنها توفير نفس نموذج تحليلات المسح.

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

الـ webhook هو استدعاء HTTP رجعي يمكنه إخطار خادمك عند حدوث حدث مسح. تكون الـ webhooks مفيدة عندما يجب أن تُشغّل بيانات المسح إجراءات لاحقة في الوقت الفعلي، مثل تسجيل النقاط للعملاء المحتملين أو بحث المخزون أو إسناد الحملة.

أخطاء شائعة في تكامل واجهة برمجة تطبيقات رمز QR

أكثر أخطاء واجهة برمجة تطبيقات رمز QR شيوعاً هي كشف مفاتيح API واختيار رموز QR الثابتة للوجهات التي ستتغير وتخطي معالجة الأخطاء وطلب صور صغيرة جداً للطباعة وقص المنطقة الهادئة حول رمز QR.

ترميز مفاتيح API بشكل ثابت في الكود من جانب العميل

رأينا فرقاً تكشف المفاتيح في JavaScript للمتصفح وملفات ثنائية للجوال. أجرِ استدعاءات API دائماً من بيئة موثوقة من جانب الخادم.

استخدام QR الثابت عندما يكون QR الديناميكي مطلوباً

إذا كانت الوجهة قد تتغير بعد الطباعة، استخدم رمز QR ديناميكياً مع طبقة إعادة توجيه. رموز QR الثابتة تتطلب إعادة الإنشاء وإعادة الطباعة.

عدم معالجة أخطاء API أو حدود المعدل

تعامل مع الاستجابات غير 2xx وأعد المحاولة فقط عند الأمان، واعرض حالات فشل واضحة في منتجك بدلاً من إسقات إنشاء QR بصمت.

إنشاء صور QR بدقة منخفضة للغاية

يمكن أن يبدو مخرج PNG الصغير جيداً على الشاشة لكنه يفشل في التغليف أو اللافتات. استخدم SVG للمخرجات القابلة للتوسع أو اطلب أبعاد PNG أكبر للطباعة.

تجاهل متطلبات المنطقة الهادئة

المنطقة الهادئة هي الهامش الفارغ حول رمز QR. قص هذا الهامش يمكن أن يجعل رمز QR الصالح صعب المسح أو مستحيلاً.

أفضل الممارسات لتكامل واجهة برمجة تطبيقات رمز QR

يحافظ تكامل واجهة برمجة تطبيقات رمز QR القوي على المفاتيح في جانب الخادم ويتحقق من الوجهات قبل الإنشاء ويستخدم رموز QR الديناميكية للحملات القابلة للتغيير ويختار SVG للعرض القابل للتوسع على الويب ويراقب تحليلات المسح بعد الإطلاق.

استخدم QR الديناميكي للوجهات القابلة للتغيير

الحملات وصفحات المنتجات والمستندات الداعمة والملصقات المطبوعة غالباً ما تتغير بعد التوزيع. رموز QR الديناميكية تمنع إعادة الطباعة المكلفة.

خزّن مؤقتاً صور QR الثابتة المُنشأة

إذا كانت حمولة رمز QR الثابت دائمة، خزّن الأصل المُنشأ وأعد استخدامه بدلاً من إنشاء نفس الرمز مراراً وتكراراً.

طابق التنسيق مع القناة

استخدم SVG لواجهات الويب التكيفية وPNG لسير عمل الطباعة والبريد الإلكتروني البسيطة وJSON أو base64 عندما تحتاج الأنظمة اللاحقة إلى بيانات صورة مضمّنة.

تحقق من صحة عناوين URL للوجهات

تحقق من صحة URLs ونوّعها قبل الإنشاء حتى لا تصبح الوجهات المعطوبة أو غير الآمنة أو المشوّهة أصولاً مطبوعة.

راقب التحليلات بعد النشر

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

مسرد مصطلحات واجهة برمجة تطبيقات رمز QR

في مصطلحات QR-Build، تجمع واجهة برمجة تطبيقات رمز QR نقطة نهاية مصادق عليها وحمولة طلب وتنسيق مخرجات وإدارة إعادة توجيه ديناميكية اختيارية. تحدد هذه المصطلحات الأجزاء المتحركة التي يحتاجها المطورون قبل التكامل.

نحدد هذه المصطلحات باستمرار عبر منتج QR-Build وواجهة API والتوثيق حتى يتمكن المطورون والمسوّقون ومديرو المنتجات من اتخاذ نفس قرارات التنفيذ.

مفتاح API

مفتاح API هو سلسلة بيانات اعتماد فريدة تصادق كل طلب إلى QR-Build API وتربط الاستخدام بحسابك.

نقطة نهاية

نقطة النهاية هي URL محدد يرسل إليه عميلك طلبات، مثل POST /v1/qr للإنشاء أو GET /v1/qr/{id}/analytics للإبلاغ.

QR ديناميكي

رمز QR الديناميكي هو رمز QR يشير URL المشفر فيه إلى طبقة إعادة توجيه مُدارة من الخادم، مما يتيح تغيير الوجهة النهائية بعد طباعة رمز QR.

طبقة إعادة التوجيه

طبقة إعادة التوجيه هي URL مُدارة من QR-Build مشفرة في رمز QR الديناميكي؛ توجّه الماسحين إلى الوجهة الحالية وتمكّن التحليلات.

تحليلات المسح

تحليلات المسح هي بيانات تُجمع عند مسح رمز QR الديناميكي، بما في ذلك العدد والطابع الزمني ونوع الجهاز والموقع الجغرافي.

Base64

Base64 هو ترميز من الثنائي إلى النص يتيح لبيانات صورة QR الانتقال داخل JSON أو HTML دون طلب ملف صورة منفصل.

Webhook

الـ webhook هو استدعاء HTTP رجعي يخطر خادمك عند حدوث حدث مسح أو حدث سير عمل QR.

أسئلة شائعة حول واجهة برمجة تطبيقات رمز QR

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

إجابات على أسئلة المطورين والمنتجات والتكامل حول استخدام QR-Build API.

ما هي واجهة برمجة تطبيقات رمز QR؟

واجهة برمجة تطبيقات رمز QR هي نقطة نهاية REST تقبل معاملات QR مثل النوع وURL والحجم والتنسيق، ثم تعيد صورة رمز QR أو كائن بيانات. تتيح للمطورين إنشاء رموز QR من كود التطبيق بدلاً من استخدام مولّد يدوي.

كيف أنشئ رمز QR باستخدام API؟

صادق بمفتاح API وأرسل طلب POST مع معاملات QR واقرأ استجابة PNG أو SVG أو JSON المعادة. أبسط تكامل لـ URL QR هو طلب HTTP من جانب الخادم مع نص JSON.

هل QR-Build API مجاني؟

يقدم QR-Build وصولاً مجانياً للبدء بإنشاء QR الثابت. قد تتطلب رموز QR الديناميكية وتحليلات المسح والحجم الأعلى وميزات الإنتاج خطة مدفوعة؛ تحقق من التفاصيل الحالية في صفحة الأسعار.

ما تنسيقات المخرجات التي تدعمها واجهة برمجة تطبيقات رمز QR؟

يدعم API استجابات PNG وSVG وbase64 وJSON. استخدم PNG للطباعة والبريد الإلكتروني البسيطين وSVG للويب القابل للتوسع أو عرض الطباعة وJSON أو base64 عندما يحتاج تطبيقك إلى بيانات وصفية وبيانات صورة مضمّنة.

ما الفرق بين رموز QR الثابتة والديناميكية عبر API؟

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

هل يمكنني تحديث وجهة رمز QR الديناميكي عبر API؟

نعم. أرسل طلب PATCH إلى نقطة نهاية إدارة رمز QR مع URL الوجهة الجديد. لا يحتاج رمز QR المطبوع إلى إعادة إنشاء لأن طبقة إعادة التوجيه توجّه عمليات المسح المستقبلية إلى الوجهة المحدثة.

كيف أنشئ رموز QR جماعية عبر API؟

استخدم طلب دفعة مع مصفوفة من معاملات QR. يمكن أن يعيد API الأصول المُنشأة كأرشيف ZIP أو نتيجة وظيفة أو مصفوفة JSON اعتماداً على الحجم وتكوين الحساب.

ما أنواع رمز QR التي يمكنني إنشاؤها عبر API؟

اعتباراً من عام 2026، يدعم QR-Build URL وWiFi وvCard وPDF والبريد الإلكتروني والهاتف والقائمة والقسيمة والعملة المشفرة وPayPal والتقويم وسير عمل QR الجماعي من خلال الإنشاء الموجّه بـ API.

ما المصادقة التي تستخدمها واجهة برمجة تطبيقات رمز QR؟

يستخدم API مصادقة مفتاح API. أرسل المفتاح كرمز Bearer في رأس Authorization واحتفظ به في جانب الخادم.

كيف أحافظ على أمان مفتاح API الخاص بي؟

خزّن مفاتيح API في متغيرات البيئة أو مدير الأسرار وأجرِ استدعاءات QR-Build من خادمك ولا تكشف المفاتيح أبداً في JavaScript من جانب العميل وقم بتدوير المفاتيح إذا تمت إتاحتها أو مشاركتها عن طريق الخطأ.

هل يمكنني الوصول إلى تحليلات المسح عبر API؟

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

ما لغات البرمجة التي تعمل مع واجهة برمجة تطبيقات رمز QR؟

يمكن لأي لغة تستطيع إجراء طلبات HTTPS استخدام API، بما في ذلك JavaScript وTypeScript وPython وRuby وPHP وGo وSwift وKotlin وJava وC#.

ما حجم الصورة الذي يجب أن أطلبه للاستخدام في الطباعة؟

للطباعة، اطلب PNG كبيراً أو استخدم SVG عندما يكون ذلك ممكناً. SVG مستقل عن الدقة، بينما يجب أن يكون حجم PNG كافياً لأبعاد الطباعة النهائية ومسافة المسح.

متى يجب أن أستخدم واجهة برمجة تطبيقات رمز QR بدلاً من مولّد يدوي؟

استخدم API للتوسع والأتمتة وتكامل المنتجات والإنشاء في الوقت الفعلي وسير عمل الحملات. استخدم مولّداً يدوياً لرموز QR المفردة العرضية التي لا تحتاج إلى أتمتة.

هل يمكنني استخدام واجهة برمجة تطبيقات رمز QR في تطبيق جوال؟

نعم، لكن قم بتوجيه الاستدعاءات من خلال خادمك وسلّم URL الصورة المُنشأة أو البيانات إلى التطبيق. لا تضمّن مفتاح API في ملف ثنائي لـ iOS أو Android لأنه يمكن استخراجه.

موارد QR-Build ذات الصلة

ادمج إنشاء QR في منتجك

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

تتغير حدود المعدل وتفاصيل الخطة بمرور الوقت؛ تحقق من حدود الإنتاج الحالية قبل النشر.

QR Code - QR-Build

هل تحتاج إلى إنشاء رموز QR من الكود؟

احصل على وصول API