الاخطاء وحدود الاستخدام
مرجع شامل لرموز الاخطاء وسياسات حدود الاستخدام
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
200 | OK | الطلب نجح |
201 | Created | تم انشاء المورد بنجاح |
400 | Bad Request | بيانات الطلب غير صحيحة |
401 | Unauthorized | مفتاح API غير صالح او مفقود |
403 | Forbidden | لا تملك صلاحية لهذا الاجراء |
404 | Not Found | المورد غير موجود |
409 | Conflict | تعارض مع الحالة الحالية |
422 | Unprocessable Entity | البيانات صحيحة الشكل لكن غير قابلة للمعالجة |
429 | Too Many Requests | تجاوز حد الاستخدام |
500 | Internal Server Error | خطأ داخلي في الخادم |
شكل رسالة الخطأ
جميع الاخطاء تُرجع بصيغة موحدة:
رموز الاخطاء المخصصة
اخطاء المصادقة
| الرمز | الوصف |
|---|---|
AUTH_TOKEN_EXPIRED | انتهت صلاحية التوكن |
AUTH_TOKEN_INVALID | التوكن غير صالح |
AUTH_INSUFFICIENT_PERMISSIONS | صلاحيات غير كافية |
اخطاء المتجر
| الرمز | الوصف |
|---|---|
STORE_NOT_FOUND | المتجر غير موجود |
STORE_SUSPENDED | المتجر موقوف |
STORE_PLAN_LIMIT | تجاوز حد الخطة |
اخطاء المنتجات
| الرمز | الوصف |
|---|---|
PRODUCT_NOT_FOUND | المنتج غير موجود |
PRODUCT_OUT_OF_STOCK | المنتج نفذ من المخزون |
PRODUCT_LIMIT_REACHED | وصلت لحد المنتجات في خطتك |
اخطاء الـ AI
| الرمز | الوصف |
|---|---|
INSUFFICIENT_AI_CREDITS | رصيد AI غير كافٍ |
AI_PROCESSING_FAILED | فشل في معالجة الـ AI |
AI_IMAGE_INVALID | الصورة غير مناسبة للتحليل |
AI_RATE_LIMIT | تجاوز حد طلبات AI |
اخطاء الدفع
| الرمز | الوصف |
|---|---|
PAYMENT_FAILED | فشل الدفع |
PAYMENT_GATEWAY_ERROR | خطأ في بوابة الدفع |
REFUND_EXCEEDS_AMOUNT | مبلغ الاسترداد اكبر من المبلغ الاصلي |
حدود الاستخدام (Rate Limits)
حسب الخطة
| الخطة | الحد | الفترة |
|---|---|---|
| اساسي | 100 طلب | دقيقة |
| احترافي | 500 طلب | دقيقة |
| مؤسسي | 2000 طلب | دقيقة |
حسب الـ Endpoint
| المجموعة | الحد | الفترة |
|---|---|---|
| قراءة (GET) | 300/دقيقة | عام |
| كتابة (POST/PUT/DELETE) | 100/دقيقة | عام |
| AI Endpoints | حسب الجدول اعلاه | لكل endpoint |
| Webhooks | 50 webhook/متجر | اجمالي |
هيدرات الحدود
كل استجابة تحتوي هيدرات تبيّن حالة الحدود:
عند تجاوز الحد
عند تجاوز الحد، ستحصل على 429 Too Many Requests:
نصيحة: استخدم Exponential Backoff عند الحصول على 429 -- انتظر 1 ثانية، ثم 2، ثم 4، وهكذا.