المفاهيم

حدود المعدل

لكل مفتاح ولكل شركة، تُحتسب بالدقيقة.

الطلبات	لكل مفتاح	لكل شركة
كل المسارات	60 في الدقيقة	120 في الدقيقة
ملفات PDF والتقارير	10 في الدقيقة	30 في الدقيقة

عند تجاوز الحد تجيب الواجهة 429 RATE_LIMITED مع ترويسة Retry-After وretryAfter في الجسم، وكلاهما بالثواني. انتظر تلك المدة ثم أرسل الطلب نفسه مجددًا.

http

HTTP/1.1 429 Too Many Requests
Retry-After: 12
{ "error": "Too many requests. Try again in 12 seconds.", "code": "RATE_LIMITED", "retryAfter": 12 }

حد الشركة تتقاسمه كل مفاتيحها: نظامان على الشركة نفسها يتقاسمان 120 طلبًا في الدقيقة.
زامن عبر updatedSince بدل قراءة كل السجلات في كل مرة (الصفحات والمزامنة).
اطلب ملفات PDF فقط عندما يحتاجها أحد.