حدود المعدل
نوافذ ثابتة من دقيقة واحدة لكل تطبيق. الحدود تحمي المنظمة المجاورة كما تحمينا: نصف قطر الانفجار تطبيق واحد.
| الفئة | العمليات | الحد |
|---|---|---|
| قراءة | كل GET تحت /v1 | 600 / min |
| كتابة | POST /v1/customers · POST /v1/webhook-endpoints · …/test | 120 / min |
| تشغيل الوكيل | POST /v1/inbound-events | 60 / min |
| نقطة الرمز | POST /v1/oauth/token | ٢٠ / min لكل client_id و٢٠ / min لكل IP |
الترويسات
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 597
X-RateLimit-Reset: 1725436800
HTTP/1.1 429 Too Many Requests
Retry-After: 23
{ "code": "rate_limited", "detail": "Limit 600/min for read requests; retry in 23s", … }تراجع لمدة Retry-After. الاستمرار بعد 429 يُحسب على النافذة نفسها ولا يعيد ضبطها.
حدود أخرى
| ماذا | الحد |
|---|---|
| جسم JSON | 1 MB → 413 |
| نص الحدث الوارد | ٢٠٬٠٠٠ حرف |
| وسائط الحدث | ١٠ عناصر |
| حجم الصفحة | limit من ١ إلى ١٠٠، الافتراضي ٢٥ |
| رسائل المحادثة | آخر ٥٠٠ رسالة |
| نقاط webhook | ١٠ لكل تطبيق |
| التطبيقات | ٥٠ لكل منظمة |
الحدود تُرفع لتطبيق بعينه بسبب معلن، ولا تُخفض بصمت. 202 على الحدث الوارد يعني «حُفظ» — الوكيل يجيب على ساعته ضمن سقوف الإرسال (٢٠ رسالة/ثانية للمنظمة، ١/ثانية للعميل) ومحفظته.