REST APIواجهة REST

API docsتوثيق الواجهة

Programmatic access to QR codes, scan analytics, and workspace metadata. Authenticate with an API key from /api-keys. Machine-readable OpenAPI 3.1 spec at /openapi.json.واجهة برمجية للوصول إلى الرموز وتحليلات المسح ومعلومات المساحة. صادق بمفتاح API من /api-keys. مواصفات OpenAPI 3.1 جاهزة للقراءة الآلية على /openapi.json.

Authenticationالمصادقة

All requests need a Bearer token in the Authorization header. Generate keys at /api-keys; the raw key is shown once at creation, then only the prefix is visible. Keys are scoped to a single workspace.تتطلب كل الطلبات Bearer token في ترويسة Authorization. أنشئ المفاتيح على /api-keys؛ يُعرض المفتاح الخام مرة واحدة عند الإنشاء، ثم تظهر البادئة فقط. المفاتيح مرتبطة بمساحة واحدة.

Authorization: Bearer qrf_live_...

Rate limitsحدود المعدل

Per-key per-minute limits, returned in response headers:حدود بالدقيقة لكل مفتاح، تُعاد في ترويسات الاستجابة:

  • Free — 60 req/min
  • Pro — 300 req/min
  • Business — 1,000 req/min
X-RateLimit-Plan: pro
X-RateLimit-Limit: 300

Endpointsالمسارات

GET/api/v1/qr

List QR codesقائمة رموز QR

Paginated list of QR codes in your workspace.قائمة مرقّمة لرموز QR في مساحتك.

curl -s "https://www.qra.cc/api/v1/qr?page=1&limit=20" \
  -H "Authorization: Bearer qrf_live_..."
POST/api/v1/qr

Create QR codeإنشاء رمز QR

Creates a new dynamic QR code (subject to your plan's code-count limit).ينشئ رمزاً ديناميكياً جديداً (وفق حد عدد الرموز في خطتك).

curl -s "https://www.qra.cc/api/v1/qr" \
  -H "Authorization: Bearer qrf_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Q4 insert","type":"url","destination":"https://example.com/q4"}'
GET/api/v1/qr/{id}

Get QR codeجلب رمز QR

Fetch a single QR code by id.اجلب رمزاً واحداً حسب المعرّف.

curl -s "https://www.qra.cc/api/v1/qr/<id>" \
  -H "Authorization: Bearer qrf_live_..."
PATCH/api/v1/qr/{id}

Update QR codeتعديل رمز QR

Update name, destination, or status (active / paused / expired).حدّث الاسم أو الوجهة أو الحالة (نشط/موقوف/منتهي).

curl -s -X PATCH "https://www.qra.cc/api/v1/qr/<id>" \
  -H "Authorization: Bearer qrf_live_..." \
  -H "Content-Type: application/json" \
  -d '{"destination":"https://example.com/new-url"}'
DELETE/api/v1/qr/{id}

Delete QR codeحذف رمز QR

Permanently delete a QR code and all its scans.احذف رمزاً وجميع عمليات مسحه نهائياً.

curl -s -X DELETE "https://www.qra.cc/api/v1/qr/<id>" \
  -H "Authorization: Bearer qrf_live_..."
GET/api/v1/qr/{id}/scans

List scansقائمة عمليات المسح

Raw per-scan log with timestamp, country, device, OS, browser, referrer. Use ?since= and ?until= for windowed queries.سجل المسح الخام مع الطابع الزمني والدولة والجهاز ونظام التشغيل والمتصفح والمصدر. استخدم since و until للنوافذ الزمنية.

curl -s "https://www.qra.cc/api/v1/qr/<id>/scans?since=2026-04-01T00:00:00Z" \
  -H "Authorization: Bearer qrf_live_..."