حدود الطلبات

الحدود

تُحتسب الحدود لكل مفتاح، وتتشارك مفاتيح المنشأة كلها أيضًا حصة المنشأة، فلا تمنحك المفاتيح الإضافية طلبات أكثر. الطلب المرفوض يرد بـ 429 rate_limited مع ترويسة Retry-After بالثواني وترويسات X-RateLimit-*:

HTTP/1.1 429 Too Many Requests
Retry-After: 17
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0

{"ok":false,"error":{"code":"rate_limited","message":"Too many requests. Wait for the time given in the Retry-After header, then try again."}}

إعادة المحاولة بالطريقة الصحيحة

• عند 429 انتظر ثواني Retry-After ثم أعد المحاولة.
• عند خطأ شبكة أو 5xx أعد المحاولة بفواصل متضاعفة (مثلًا 1 ثم 2 ثم 4 ثم 8 ثوانٍ) وبنفس external_reference.
• لا تعد محاولة ردود 4xx الأخرى؛ صحّح الطلب.
• وزّع الأعمال الكبيرة على الوقت بدل إرسالها دفعة واحدة، وأنشئ الفواتير من مهمة في الخلفية.