المصادقة
يدعم مرقم نوعين أساسيين من المصادقة:
- وصول الآلات عبر
Authorization: Bearer <مفتاح API>— موصى به للاتصال بين الخوادم. - وصول جلسة المستخدم عبر
Authorization: Bearer <Clerk JWT>— تستخدمه لوحة التحكم.
كلاهما يستخدم رأس Authorization القياسي مع Bearer token.
Base URL
text
https://api.mirqam.net
للتطوير المحلي:
text
http://localhost:8000
مصادقة الآلات — مفتاح API
أنشئ مفتاح API من لوحة التحكم. تبدأ المفاتيح بـ ak_....
أرسله كـ Bearer token في كل طلب:
http
Authorization: Bearer ak_live_********
يعمل هذا مع نقاط /v1/* الموجهة للآلات مثل:
GET /v1/fontsGET /v1/templatesPOST /v1/render
Note
عمليات تأليف القوالب (إنشاء/تعديل/حذف) متاحة من المحرر فقط، ولا يمكن تشغيلها عبر مفتاح الـ API.
مصادقة الجلسة — Clerk JWT
تستخدم لوحة التحكم جلسات Clerk وترسل JWT كـ Bearer token:
http
Authorization: Bearer <CLERK_SESSION_JWT>
مطلوب للوصول إلى:
/v1/meو/v1/me/*/v1/admin/*(يتطلب دور admin أيضًا)
Note
في البيئة الإنتاجية، افترض أن جميع نقاط /v1/* تتطلب مصادقة. في بيئة التطوير المحلية بدون إعداد Clerk، قد تكون النقاط مفتوحة.
معرّفات الطلبات
كل استجابة تتضمن رأس X-Request-Id. تتضمنه الأخطاء أيضًا في حقل request_id.
يمكنك تعيين المعرّف بنفسك لتتبع الطلبات في سجلاتك:
http
X-Request-Id: 6d5f0a03-0b38-4f03-bd6f-4e9f0c0a03a1