حدود المعدّل

لكل مفتاح API حدّ مستدام للطلبات في الثانية مشتق من خطّتك (Free 1 req/s → Max 60 req/s — راجع التسعير). تُفرَض الحدود عبر دلو رموز: يُسمح بالدفعات حتى سعتك لكل دقيقة، ثم تُنعَّم الطلبات إلى المعدّل المستدام.

عندما تتجاوز الحدّ

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429، وerror: "rate_limited".
يخبرك retry_after_ms بالحد الأدنى للوقت الذي يجب انتظاره قبل إعادة المحاولة.
تُبلّغ ترويسة x-ratelimit-remaining في كل استجابة عن عدد الطلبات المتبقية في هذه الدقيقة.

التزامن

إلى جانب معدّل الطلبات في الثانية، هناك حدّ أقصى للطلبات قيد التنفيذ. إذا أطلقت طلبات كثيرة دفعةً واحدة فقد ترى:

409 request_in_progress — طلب متطابق غير قابل لإعادة التأثير قيد التشغيل بالفعل.
503 too_many_concurrent_requests — عدد كبير جداً من الطلبات المتزامنة قيد التنفيذ؛ تراجع وأعِد المحاولة.

التعامل مع الحدود

احترم retry_after_ms؛ وإلا فاستخدم التراجع التدريجي الأسّي مع تشويش عشوائي.
حافظ على حدّ تزامن في جانب العميل يطابق معدّل خطّتك.
تقوم حزم SDK الرسمية بإعادة محاولة 429/503 تلقائياً.