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

إنشاء صور رمز الاستجابة السريعة بإضافة .qr.png إلى أي رابط قصير من Linkly. لا تتطلب مصادقة أو مفتاح API.

يتم إرجاع الصورة كـ PNG مع تطبيق جميع أنماط رموز الاستجابة السريعة المحفوظة، بما في ذلك الألوان المخصصة وأنماط النقاط وأنماط العيون والشعارات.

الاستخدام الأساسي

أضف .qr.png إلى أي رابط قصير من Linkly:

https://linkly.link/2W6Z9.qr.png

يؤدي هذا إلى إرجاع صورة PNG بحجم 1024x1024 لرمز الاستجابة السريعة. إذا قمت بتخصيص ألوان رمز الاستجابة السريعة أو النمط أو الشعار في Linkly، يتم تطبيق هذه الأنماط تلقائياً.

مثال

تضمين رمز الاستجابة السريعة في صفحة HTML:

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

أو استخدمه في قالب بريد إلكتروني أو ملف PDF أو أي نظام يدعم عناوين URL للصور.

معاملات النمط

مرر معاملات الاستعلام لتجاوز أنماط رمز الاستجابة السريعة المحفوظة للرابط أو تغيير حجم الصورة:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

ملاحظة: يجب تشفير الألوان السادسة عشرية في URL — استخدم %23 بدلاً من # (على سبيل المثال %23ff0000 لـ #ff0000).

يتم توسيع أبعاد الشعار تلقائياً لمطابقة حجم الصورة المطلوب.

يضيف quietZone حشواً من المساحة البيضاء حول رمز الاستجابة السريعة بالكامل، ممتلئة بـ bgColor. هذا مفيد عند طباعة رموز الاستجابة السريعة على خلفيات مظلمة — بدونها، تجلس عيون التحديد الموضعي بشكل مباشر ضد الحافة وقد لا تكون قابلة للمسح بشكل موثوق. على سبيل المثال، quietZone=50&bgColor=%23ffffff يضيف حد أبيض بحجم 50 بكسل.

تعيين الأنماط عبر واجهة برمجة تطبيقات الرابط

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

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

بمجرد حفظها، يتم تطبيق هذه الأنماط تلقائياً كلما طلبت صورة .qr.png — بدون الحاجة إلى معاملات الاستعلام.

كيفية تطبيق الأنماط

يتم حل أنماط رمز الاستجابة السريعة بالترتيب التالي:

1. 1
   الأنماط الافتراضية — مقدمة سوداء على خلفية شفافة، وحدات مربعة، 1024 بكسل
2. 2
   الأنماط المحفوظة — يتم تخزين أي تخصيصات قمت بها في محرر رمز الاستجابة السريعة أو عيّنتها عبر واجهة برمجة التطبيقات مع الرابط
3. 3
   تجاوزات معاملات الاستعلام — تجاوز الأنماط الفردية لكل طلب عبر معاملات URL

عند وجود شعار، يستخدم Linkly تلقائياً تصحيح الخطأ العالي (المستوى H) لضمان بقاء رمز الاستجابة السريعة قابلاً للمسح.

حدود المعدل

يقتصر نقطة النهاية على 5 طلبات في الثانية لكل عنوان IP. يتم تخزين الصور مؤقتاً لمدة 5 دقائق، لذلك يتم تقديم الطلبات المتكررة لنفس رمز الاستجابة السريعة بسرعة.

الاستجابة

يرجع الطلب الناجح حالة 200 مع Content-Type: image/png وبيانات صورة PNG كجسم الاستجابة.

تُرجع استجابات الخطأ JSON:

{"error": "Rate limit exceeded"}

الموارد ذات الصلة

• إنشاء رموز الاستجابة السريعة - كيفية إنشاء وتخصيص رموز الاستجابة السريعة في Linkly
• إضافة شعار إلى رمز الاستجابة السريعة - إنشاء رموز الاستجابة السريعة ذات العلامات التجارية برابطك الشعار
• رموز الاستجابة السريعة بصيغة SVG - تنزيل رموز الاستجابة السريعة بصيغة متجهة قابلة للتوسع
• واجهة برمجة تطبيقات تقصير الرابط - إنشاء وإدارة الروابط برمجياً
• واجهة برمجة تطبيقات التحليلات - تصدير بيانات النقرات وتقارير حركة المرور