المصادقة
تستخدم واجهة دُرج مصادقة Bearer Token. كل طلب يجب أن يتضمن مفتاح API صالح في رأس Authorization.
صيغة المفتاح
Authorization: Bearer tjr_a1b2c3d4e5f6...إنشاء المفاتيح
- سجل الدخول إلى لوحة التحكم في
admin.durj.ly - اذهب إلى التكاملات
- اضغط إنشاء مفتاح API جديد
- أعطه اسماً وصفياً (مثل “تكامل Odoo”)
- انسخ المفتاح فوراً — لن يظهر مرة أخرى
أمان المفاتيح
- المفاتيح تُخزن كـ SHA-256
- كل مفتاح مرتبط بمتجر واحد
- يمكن إلغاء المفاتيح فوراً من لوحة التحكم
استجابات الخطأ
401 غير مصرح
{ "statusCode": 401, "message": "Missing or invalid Authorization header. Use: Bearer <token>"}429 تجاوز الحد
{ "statusCode": 429, "message": "Rate limit exceeded. Please retry after the window resets."}أفضل الممارسات
- لا تكشف المفاتيح في الواجهة الأمامية
- استخدم مفاتيح مختلفة للتطوير والإنتاج
- قم بتدوير المفاتيح بانتظام
- حدد تاريخ انتهاء للمفاتيح المؤقتة