أسماء الحقول ورموز الأخطاء وأمثلة الشيفرة بالإنجليزية، كما تستخدمها في برنامجك.
الأخطاء والحدود
رموز الحالة وأجسام الأخطاء وحدود المعدل وإعادة المحاولة.
json
{
"error": { "code": "insufficient_scope", "message": "This key needs the `rooms:write` scope." },
"request_id": "req_4f1c0d2e9a7b41c3a8e5"
}أرفق request_id (يُرسل أيضًا في ترويسة X-Request-Id) عند مراسلة الدعم.
| الحالة | الرمز | المعنى |
|---|---|---|
| 400 | invalid_request · invalid_json | راجع error.details لمعرفة الحقول |
| 401 | unauthorized | مفتاح مفقود أو غير صالح أو ملغى أو منتهٍ |
| 403 | insufficient_scope · forbidden | المفتاح أو مُنشئه لا يملك هذه الصلاحية |
| 404 | not_found | غير موجود، أو خارج نطاق المفتاح |
| 402 | insufficient_credit | نفد رصيد الواجهة البرمجية — اشحنه من المطوّرون ← الفوترة |
| 409 | conflict | مثلًا: الغرفة مقفلة |
| 413 | payload_too_large | حجم الجسم محدود بـ ٦٤ كيلوبايت |
| 429 | rate_limited | انتظر المدة في Retry-After |
| 503 | media_unavailable | مؤقت؛ أعد المحاولة بتباعد متزايد |
حدود المعدل
لكل مفتاح ١٢٠ طلبًا في الدقيقة. وتتضمن الاستجابات X-RateLimit-Limit وX-RateLimit-Remaining. أعد محاولة ردود 429 و5xx بتباعد متزايد، وحزمة SDK تفعل ذلك نيابة عنك.
| المورد | الحد |
|---|---|
| مفاتيح API الفعّالة لكل مساحة عمل | ٢٥ |
| نقاط الويب هوك لكل مساحة عمل | ١٠ |
| مدة صلاحية رابط الانضمام | ٧ أيام |
| مدة صلاحية رمز الوسائط (للاتصال) | ١٠ دقائق |
| عدد المشاركين في الاجتماع | ٣٠٠ |
| خيارات الاستطلاع | ١٠ |
| حجم التسجيل | ٦ غيغابايت |