iloveQR
    خطط وأسعارأسئلة شائعةAPI
    تسجيل
    iloveQR

    أنشئ وخصص وتتبع رموز QR لعملك. منصة رموز QR الكاملة مع التحليلات والتعاون الجماعي.

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

    © 2026 iloveQR. جميع الحقوق محفوظة.

    توثيق API
    وثائق API
    البدء
    مقدمةبدء سريعالمصادقة
    المصادقة
    رموز QR
    عمليات جماعية
    التحليلات
    ويب هوكس

    روابط سريعة

    احصل على مفتاح APIابدأ تجربة مجانية
    المصادقة

    مصادقة API

    تتطلب جميع طلبات API المصادقة باستخدام مفتاح API. تشرح هذه الدليل كيفية إنشاء وإدارة واستخدام مفاتيح API بشكل آمن.

    الحصول على مفتاح API

    للحصول على مفتاح API، تحتاج إلى أن يكون لديك حساب iloveQR وأن تكون جزءًا من منظمة.

    1

    تسجيل الدخول إلى حسابك

    تسجيل الدخول أو إنشاء حساب إذا لم يكن لديك واحد.

    2

    انتقل إلى صفحة المطورين

    اذهب إلى لوحة التحكم → المطورين لإدارة مفاتيح API الخاصة بك.

    3

    إنشاء مفتاح API جديد

    انقر على 'إنشاء مفتاح API'، أعطه اسمًا وصفيًا، واحفظ المفتاح الذي تم إنشاؤه بشكل آمن.

    استخدام مفتاح API الخاص بك

    قم بتضمين مفتاح API الخاص بك في رأس X-API-Key مع كل طلب:

    رأس الطلب
    curl -X GET \
      https://api.iloveqr.com/api/v1/organizations/YOUR_ORG_ID/qr-codes \
      -H "X-API-Key: ilqr_your_api_key_here" \
      -H "Content-Type: application/json"

    معرف المنظمة

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

    احصل على منظماتك
    curl -X GET \
      https://api.iloveqr.com/api/v1/users/me/organizations \
      -H "X-API-Key: ilqr_your_api_key_here"
    استجابة
    {
      "organizations": [
        {
          "id": "org_abc123",
          "name": "My Company",
          "slug": "my-company",
          "role": "ADMIN"
        }
      ]
    }

    أفضل ممارسات الأمان

    لا تكشف أبداً عن مفاتيح API في كود جانب العميل

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

    استخدم متغيرات البيئة

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

    قم بتدوير المفاتيح بانتظام

    قم بإنشاء مفاتيح API جديدة بشكل دوري وألغِ القديمة. إذا كنت تشك في أن مفتاحًا قد تم اختراقه، قم بإلغائه على الفور.

    أخطاء المصادقة

    عندما تفشل المصادقة، تعيد API واحدة من استجابات الخطأ هذه:

    رمز الحالةخطأوصف
    401
    UNAUTHORIZEDمفتاح API مفقود أو غير صالح
    403
    FORBIDDENمفتاح API ليس لديه إذن لهذا الإجراء
    403
    API_KEY_REVOKEDتم إلغاء مفتاح API
    مثال على استجابة الخطأ
    {
      "statusCode": 401,
      "message": "Invalid or missing API key",
      "error": "Unauthorized"
    }

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

    الآن بعد أن فهمت المصادقة، تعلم كيفية استخدام API: