توثيق المطوّرين

REST API لخدمة تصنيف سلامة رموز QR والباركود من Abundera QR Check. أرسل حمولة مفككة واحصل على حكم مع تتبع السلسلة.

مواصفات API

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

المرجع التفاعلي لـ API ←

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

OpenAPI 3.1 (YAML)

المواصفة الكاملة مع المخططات والأوصاف والأمثلة. مثالية لمولّدات التوثيق.

OpenAPI 3.1 (JSON)

المواصفة ذاتها بتنسيق JSON. مثالية للاستهلاك البرمجي والأدوات.

Postman Collection v2.1

استورد إلى Postman أو Insomnia. مُهيّأة مسبقاً بمتغيرات {{base_url}} و{{token}}.

المصادقة

نقطة النهاية العامة POST /api/scan مقيّدة بحصة مجهولة المستخدم (10 طلبات في الدقيقة كحد أقصى، و3 طلبات كل 24 ساعة لكل عنوان IP). تتجاوز الاشتراكات المدفوعة في الفئة Pro هذه الحصص عند تقديم مفتاح API كرمز تحمل:

Authorization: Bearer sk_live_abnd_check_…

تُسكّ مفاتيح API عند الاشتراك وتُدار عبر abundera.ai/account/api-keys. يتم التحقق بشكل موحّد من خلال المحور ويُخزَّن في KV لمدة 60 ثانية.

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

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

تنسيق الطلب: JSON (Content-Type: application/json).

تنسيق الاستجابة: JSON (application/json; charset=utf-8). تحمل الاستجابات حقل schema_version.

مثال سريع

curl -X POST https://check.qr.abundera.ai/api/scan \
  -H "Content-Type: application/json" \
  -d '{"payload":"https://example.com/login"}'

الاكتشاف (well-known)

نقاط نهاية الاكتشاف التلقائي ضمن /.well-known/ (RFC 8615). تصفح الفهرس أو اجلب مباشرة:

فهرس /.well-known/ ←

قائمة مقروءة بكل عناوين well-known URI التي ينشرها هذا الموقع.

القدرات

النطاقات ومستويات الحصة وسطح API. يجمعها المحور عبر واجهات مستخدم موحّدة.

سياسة سلامة QR

مخطط حكم Check والتنسيقات المدعومة ومصادر السمعة والموقف من الخصوصية.

فهرس API للعائلة ←

RFC 9727 Linkset على المحور يُعدّد كل واجهات Abundera API.

مواصفات API

المصادقة

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

مثال سريع

الاكتشاف (well-known)

ذات صلة