توثيق واجهة البرمجة للمطورين (API Reference)

تعيد هذه النقطة قائمة مرقمة بكافة أكواد الاستجابة السريعة (QR) الديناميكية المملوكة لحساب المستخدم صاحب المفتاح.

معلمات الاستعلام

• ●limit (اختياري) - عدد النتائج المراد إرجاعها (الافتراضي 50، الأقصى 100)
• ●offset (اختياري) - عدد النتائج المراد تخطيها (الافتراضي 0)

نموذج الاستجابة (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "b2d28fcd-a043-424a-9cfa-13fbc1379ea0",
      "short_id": "x8y2b3c4",
      "name": "Spring Campaign",
      "target_url": "https://example.com/promo",
      "is_dynamic": true,
      "expires_at": null,
      "created_at": "2026-07-30T04:14:00.000Z",
      "short_url": "http://localhost:3000/q/x8y2b3c4"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

إنشاء كود QR ديناميكي جديد يوجه من خلال نظام إعادة التوجيه الفوري لـ Wedjx.

جسم الطلب (JSON)

• ●target_url (مطلوب، نص) - رابط الوجهة المراد التوجيه إليه
• ●name (اختياري، نص) - اسم توضيحي لتنظيم كود الـ QR
• ●password (اختياري، نص) - إعداد كلمة مرور لحماية الرابط
• ●expires_at (اختياري، نص) - تاريخ ووقت انتهاء صلاحية الكود

نموذج الاستجابة (201 Created)

{
  "success": true,
  "data": {
    "id": "f83a6de4-c112-42da-aa1e-089c8a7cde12",
    "short_id": "a7b3c2d1",
    "name": "API Generated QR",
    "target_url": "https://example.com/docs",
    "is_dynamic": true,
    "expires_at": "2026-12-31T23:59:59.000Z",
    "created_at": "2026-07-30T04:14:00.000Z",
    "short_url": "http://localhost:3000/q/a7b3c2d1"
  }
}

الحصول على إحصائيات مجمعة ومصنفة لعمليات المسح حسب نوع الجهاز، الدول، المتصفحات، أنظمة التشغيل، بالإضافة لآخر 20 عملية مسح خلال آخر 365 يوماً.

نموذج الاستجابة (200 OK)

{
  "success": true,
  "data": {
    "qr_id": "b2d28fcd-a043-424a-9cfa-13fbc1379ea0",
    "short_id": "x8y2b3c4",
    "name": "Spring Campaign",
    "total_scans": 1420,
    "analytics_period_days": 365,
    "by_country": {
      "Egypt": 900,
      "United States": 420,
      "Unknown": 100
    },
    "by_device": {
      "Desktop": 800,
      "iOS": 500,
      "Android": 120
    },
    "by_browser": {
      "Chrome": 900,
      "Safari": 400,
      "Firefox": 120
    },
    "by_os": {
      "Windows": 800,
      "iOS": 500,
      "Linux": 120
    },
    "recent_scans": [
      {
        "scanned_at": "2026-07-30T04:14:00.000Z",
        "country": "Egypt",
        "device": "iOS",
        "browser": "Safari",
        "os": "iOS"
      }
    ]
  }
}