الأخطاء والأمان
تستخدم Omdaa API أكواد حالة HTTP قياسية مع جسم استجابة منسق يحتوي على حقل النجاح والرسالة والبيانات إن وجدت. يساعدك فهم أنماط الأخطاء على بناء تكاملات أكثر استقرارا.
بنية الاستجابة
{
"success": false,
"message": "وصف الخطأ",
"data": null
}أمثلة على الأخطاء الشائعة
- 400 طلب غير صحيح بسبب نقص أو خطأ في الحقول.
- 401 مصادقة غير صحيحة أو رمز مفقود.
- 403 صلاحيات غير كافية للحساب الحالي.
- 404 نقطة نهاية غير موجودة أو مورد مفقود.
- 429 عدد طلبات مرتفع في وقت قصير.
- 500 خطأ داخلي في الخادم.
ممارسات الأمان
- تخزين رموز JWT ومفاتيح API في مكان آمن وعدم مشاركتها.
- تقييد المفاتيح على بيئات أو عناوين IP محددة إن أمكن.
- تدوير المفاتيح بشكل دوري وإلغاء المفاتيح غير المستخدمة.
- التحقق من تواقيع الويب هوكس قبل معالجة البيانات.