التوثيق

REST API لمنصة الرموز الديناميكية Abundera QR Pro. أنشئ الرموز، أعد توجيه الوجهات، اسحب تحليلات المسح، أدر الفرق، وأطلق webhooks.

مواصفة API

تتّبع واجهة Abundera QR Pro API معيار OpenAPI 3.1. تصفّح المرجع التفاعلي، نزّل المواصفة، أو استوردها في عميل API المفضّل لديك.

مرجع API التفاعلي →

كل نقطة وصول مع مخططات الطلب والاستجابة، والمعاملات، وتجربة مباشرة في متصفحك. مدعوم بواسطة Scalar.

OpenAPI 3.1 (JSON)

المواصفة الكاملة، 91 نقطة وصول موجهة للعملاء. الأنسب للاستهلاك البرمجي.

مجموعة Postman

استوردها مباشرة في Postman أو Insomnia للاختبار التفاعلي.

SDKs الرسمية

عملاء مصنَّفون بأنواع لـ TypeScript وPython وGo. مرخّصة بموجب MIT، والمصدر متاح على GitHub.

سجل التغييرات

كل تغيير في API، مؤرَّخ ومرقَّم بإصدار. SemVer؛ التغييرات الجذرية تصدر تحت بادئة إصدار رئيسي جديدة.

API الداخلي

واجهة إدارة وفوترة من خدمة إلى خدمة. موثَّقة للاكتمال؛ ليست لتكاملات العملاء.

المصادقة

تستخدم واجهة QR Pro API مصادقة bearer token:

مفاتيح API · مرتبطة بالمنتج، بادئة abnd_qrpro_، تُدار من abundera.ai/account/api-keys. متاحة في خطط Business وTeam وAgency (Solo للوحة التحكم فقط).
يُعرض الـ token الخام abnd_qrpro_… مرة واحدة فقط عند الإنشاء، احفظه فوراً. نحتفظ فقط بهاش SHA-256 الخاص به؛ لا يمكن استرداد المفاتيح المفقودة.

Authorization: Bearer abnd_qrpro_…

عنوان URL الأساسي والصيغة

عنوان URL الأساسي: https://pro.qr.abundera.ai/api

صيغة الطلب: JSON (Content-Type: application/json) في POST / PATCH / DELETE.

صيغة الاستجابة: JSON (application/json; charset=utf-8).

حدود الاستخدام: لكل مفتاح API، تظهر عبر ترويسات الاستجابة X-RateLimit-Limit / -Remaining / -Reset. 1k/10k/50k طلب لكل يوم UTC في خطط Business / Team / Agency. مسار إعادة التوجيه السريع (aqr.net/{shortcode}) غير مصادَق عليه ولا ميزانية له لكل مسح.

مثال سريع

curl -X POST https://pro.qr.abundera.ai/api/v1/codes \
  -H "Authorization: Bearer abnd_qrpro_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Spring menu","destination":"https://example.com/menu","payload_type":"url"}'