المصادقة

يدعم Omdaa API طريقتين رئيسيتين للمصادقة: رموز JWT قصيرة الأمد ومفاتيح API طويلة الأمد. يجب تضمين بيانات المصادقة في رؤوس الطلبات لكل استدعاء محمي.

المصادقة باستخدام JWT

بعد تسجيل الدخول بنجاح تحصل على رمز JWT يمكن استخدامه في رؤوس الطلبات على الشكل التالي.

Authorization: Bearer YOUR_JWT_TOKEN

مفاتيح API

يمكن إنشاء مفاتيح API لاستخدام طويل الأمد دون الحاجة إلى تسجيل الدخول في كل مرة. يتم إنشاؤها من خلال نقطة النهاية المخصصة لذلك.

"function">curl "keyword">-X POST https://omdaa.com/api/v1/api class="keyword">-keys/create \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "keyword">-H "Content"keyword">-Type: application/json" \
  "keyword">-d '{
  "name": "My API Key",
  "expiresAt": "2025-12-31"
}'

لاستخدام مفتاح API في الطلبات يتم وضعه في رأس مخصص.

X-API-Key: omdaa_xxxxxxxxxxxxxxxxxxxxx

إدارة مفاتيح API

الحصول على جميع المفاتيح

"function">curl "keyword">-X GET "https://omdaa.com/api/v1/api class="keyword">-keys" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

تحديث مفتاح API

"function">curl "keyword">-X PUT https://omdaa.com/api/v1/api class="keyword">-keys/key"keyword">-id \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "keyword">-H "Content"keyword">-Type: application/json" \
  "keyword">-d '{
  "name": "Updated API Key Name"
}'

إلغاء مفتاح API

"function">curl "keyword">-X DELETE "https://omdaa.com/api/v1/api class="keyword">-keys/key"keyword">-id" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

تغيير مفتاح API

"function">curl "keyword">-X POST "https://omdaa.com/api/v1/api class="keyword">-keys/key"keyword">-id/rotate" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

💡 نصائح الأمان

احفظ مفاتيح API في مكان آمن ولا تشاركها أبداً
استخدم JWT للوصول المؤقت ومفاتيح API للوصول الدائم
قم بإلغاء المفاتيح غير المستخدمة فوراً
غيّر المفاتيح بانتظام للأمان الأفضل