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

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

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

بدء سريع

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

1

احصل على مفتاح واجهة برمجة التطبيقات الخاص بك

سجل أو قم بتسجيل الدخول، ثم قم بزيارة صفحة المطورين لإنشاء مفتاح API.

2

قم بعمل طلبك الأول

استخدم مفتاح API في رأس X-API-Key:

مثال على الطلب
curl -X POST \
  https://api.iloveqr.com/api/v1/organizations/YOUR_ORG_ID/qr-codes \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "URL",
    "name": "My Website QR",
    "data": {
      "url": "https://example.com"
    }
  }'
مثال على الرد
{
  "id": "qr_abc123",
  "type": "URL",
  "name": "My Website QR",
  "shortUrl": "https://ilqr.co/abc123",
  "data": {
    "url": "https://example.com"
  },
  "createdAt": "2024-01-15T10:30:00Z",
  "totalScans": 0
}

المصادقة

جميع طلبات واجهة برمجة التطبيقات تتطلب مصادقة باستخدام مفتاح واجهة برمجة التطبيقات. قم بتضمين مفتاحك في رأس الطلب:

X-API-Key: your_api_key_here

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

عنوان URL الأساسي

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

https://api.iloveqr.com/api/v1

حدود المعدلات

طلبات API محدودة بمعدل لضمان الاستخدام العادل واستقرار المنصة:

قصير الأجل

10

requests/second

متوسط المدى

50

requests/10 seconds

طويل الأجل

100

requests/minute

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

استكشف نقاط نهاية واجهة برمجة التطبيقات الشاملة لدينا المنظمة حسب الوظيفة:

لماذا تختار واجهة برمجة التطبيقات الخاصة بنا

سريع وموثوق

واجهة برمجة التطبيقات ذات الكمون المنخفض مع اتفاقية مستوى الخدمة (SLA) بنسبة 99.9%

آمن بشكل افتراضي

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

تحديد معدل الطلبات

حدود سخية مع استجابات خطأ واضحة

SDKs قادمة قريباً

نحن نعمل على SDKs الرسمية لـ JavaScript و Python و PHP والمزيد. اشترك ليتم إبلاغك عندما تكون متاحة.

تحتاج مساعدة؟

إذا كان لديك أسئلة حول واجهة برمجة التطبيقات أو تحتاج إلى مساعدة، تحقق من هذه الموارد: