أخطاء RTC
كل خطأ في RTC يحمل رمزًا ثابتًا وقابلًا للقراءة آليًا الرمز. قم بتفعيل الرمز، وليس نص الرسالة أبدًا: فقد يتم إعادة صياغة الرسائل، أما الرموز فلا يتم إعادة تسميتها أو إعادة استخدامها بمعنى آخر أبدًا.
شكلان للاستجابة
Section titled “شكلان للاستجابة”الافتراضي. بدون رأس الإصدار، تحتفظ الأخطاء بشكلها الأصلي، وبالتالي لا تتأثر عمليات التكامل الحالية:
{ "error": "Your plan allows 2 webhook endpoints", "code": "WEBHOOK_ENDPOINT_LIMIT" }code يظهر في الأخطاء التي لها رمز محدد. قد تحمل الأخطاء القديمة فقط error؛ X-Error-Code يحدد الرأس دائمًا اسم الرمز.
مغلف منظم. إرسال RTC-Version: 2026-11-01 مع طلب للحصول على المغلف المنظم:
curl https://api.rtc.champrep.com/v1/webhooks/endpoints \ --header "Authorization: Bearer $RTC_API_KEY" \ --header "RTC-Version: 2026-11-01" \ --header "Content-Type: application/json" \ --data '{ "url": "https://hooks.example.com/rtc" }'{ "error": { "code": "WEBHOOK_ENDPOINT_LIMIT", "message": "Your plan allows 2 webhook endpoints", "details": { "limit": 2, "used": 2 }, "requestId": "6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21", "retryable": false, "docUrl": "https://docs.champrep.com/services/rtc/errors/#webhook-endpoint-limit" }}| الحقل | المعنى |
|---|---|
code | رمز ثابت من الكتالوج |
message | شرح يمكن قراءته بواسطة الإنسان؛ لا تقم بتحليله |
details | سياق منظم اختياري، على سبيل المثال limit و used، أو issues (الحقول غير الصالحة) لـ INVALID_REQUEST |
requestId | معرف هذا الطلب، يُرسل أيضًا كـ X-Request-Id |
retryable | true عند إعادة محاولة نفس الطلب لاحقًا قد تنجح |
docUrl | رابط إلى مدخل هذا الرمز أدناه |
يعكس الرد الإصدار الذي تم تطبيقه في RTC-Version . تاريخ قبل 2026-11-01 يحتفظ بالشكل الافتراضي. انظر إصدارات.
في كل استجابة
Section titled “في كل استجابة”| رأس الرسالة | متى | المعنى |
|---|---|---|
X-Request-Id | كل استجابة | المعرف الفريد للطلب. قم بتضمينه عند الاتصال بالدعم الفني. |
X-Error-Code | كل خطأ | الرمز الثابت، في كلا شكلي الاستجابة |
Retry-After | 429، وبعض 503 | عدد الثواني التي يجب الانتظار قبل إعادة المحاولة |
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset | الردود المصادق عليها | انظر حدود المعدل |
التعامل مع الأخطاء
Section titled “التعامل مع الأخطاء”retryable: false(4xxبخلاف429): قم أولاً بتصحيح الطلب أو بيانات الاعتماد أو الخطة أو الحالة. إن تكرار الطلب دون تغيير يؤدي إلى الحصول على نفس الإجابة.retryable: true: أعد المحاولة مع التراجع الأسي والتذبذب، مع مراعاةRetry-After. أعد المحاولة للكتابة فقط عندما تكون العملية متجانسة أو بعد تسوية نتيجتها.401: بيانات الاعتماد مفقودة أو منتهية الصلاحية أو تم إلغاؤها.403: بيانات الاعتماد صالحة ولكنها تفتقر إلى نطاق أو وصول إلى المشروع أو حق الاستفادة من الخطة.404يشمل أيضًا الموارد التي تخص شخصًا آخر. لا تقم أبدًا بالتحقق من معرفات العملاء الآخرين.
كتالوج الرموز
Section titled “كتالوج الرموز”GET /v1/error-codes (بدون مصادقة) يعرض الكتالوج الحالي على النحو التالي:
{ "codes": [{ "code", "status", "retryable", "description" }] }. قد تُضاف رموز جديدة في أي وقت؛ تعامل مع الرمز غير المعروف كأنه الرمز العام لحالة HTTP الخاصة به.
الرموز العامة (رمز واحد لكل حالة HTTP، تُستخدم عندما لا ينطبق أي رمز محدد)
Section titled “الرموز العامة (رمز واحد لكل حالة HTTP، تُستخدم عندما لا ينطبق أي رمز محدد)”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
INVALID_REQUEST | 400 | لا | الطلب غير صحيح أو أحد الحقول غير صالح (details.issues تسرد الحقول). |
UNAUTHENTICATED | 401 | لا | بيانات اعتماد مفقودة أو غير صالحة أو منتهية الصلاحية. |
PAYMENT_REQUIRED | 402 | لا | يجب سداد دفعة مستحقة قبل أن يمكن استخدام هذه الخدمة. |
FORBIDDEN | 403 | لا | بيانات الاعتماد صالحة ولكن غير مسموح لها بالقيام بذلك. |
NOT_FOUND | 404 | لا | المورد غير موجود أو غير مرئي لهذه البيانات الاعتمادية. |
CONFLICT | 409 | لا | يتعارض الطلب مع الحالة الحالية. |
PAYLOAD_TOO_LARGE | 413 | لا | حجم نص الطلب كبير جدًا. |
UNSUPPORTED_MEDIA_TYPE | 415 | لا | نوع المحتوى غير مقبول. |
RANGE_NOT_SATISFIABLE | 416 | لا | نطاق البايت المطلوب غير صالح أو غير متاح. |
UNPROCESSABLE | 422 | لا | تم فهم المحتوى ولكن لا يمكن معالجته. |
RATE_LIMITED | 429 | نعم | عدد الطلبات زائد؛ انتظر حتى Retry-After ثوانٍ. |
INTERNAL | 500 | نعم | خطأ غير متوقع في الخادم؛ أعد المحاولة لاحقًا. |
SERVICE_UNAVAILABLE | 503 | نعم | غير متاح مؤقتًا؛ أعد المحاولة مع التراجع. |
الاشتراك والرصيد
Section titled “الاشتراك والرصيد”تتضمن هذه الإجابات أيضًا offers (كيفية حل المشكلة: إصدار نسخة تجريبية، أو الاشتراك، أو الترقية، أو حزمة، أو إضافة بطاقة، وكل منها يحتوي على رابط CHAMPREP«Billing») وفي الحالات التي يُقصد فيها حد معين أو ميزة معينة، feature.
| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
RTC_SUBSCRIPTION_REQUIRED | 402 | لا | لا يحتوي الحساب على اشتراك في RTC أو نسخة تجريبية أو رصيد مضمن (انظر offers). |
RTC_PAYMENT_REQUIRED | 402 | لا | تؤدي الفاتورة غير المدفوعة إلى حظر خدمة RTC؛ قم بسدادها في CHAMPREP الفوترة. |
RTC_ACCESS_DENIED | 403 | لا | سياسة المؤسسة أو الفريق أو المنصة تمنع RTC (reasonCode (يحدد أي منها). |
RTC_ALLOWANCE_EXHAUSTED | 402 | لا | تم استنفاد رصيد RTC الخاص بالاشتراك (feature يحدد أي منها؛ انظر offers). |
RTC_FEATURE_NOT_IN_PLAN | 403 | لا | لا يشمل الاشتراك هذه الميزة (انظر offers). |
RTC_PLAN_LIMIT | 403 | لا | تم الوصول إلى حد الاشتراك (حجم الغرفة، الغرف المفتوحة في نفس الوقت). |
PAYMENT_METHOD_REQUIRED | 402 | لا | تتطلب النسخة التجريبية وجود بطاقة محفوظة في مساحة العمل المدفوعة (انظر offers). |
TRIAL_ALREADY_USED | 409 | لا | تم استخدام الإصدار التجريبي المجاني بالفعل من قبل هذا الحساب. |
TRIAL_NOT_ALLOWED | 403 | لا | لا يمكن لهذا الحساب بدء الإصدار التجريبي المجاني. |
TRIAL_UNAVAILABLE | 409 | لا | الإصدار التجريبي المجاني غير متاح. |
ALREADY_SUBSCRIBED | 409 | لا | يحتوي الحساب بالفعل على اشتراك RTC. |
PRIMARY_TOKEN_REQUIRED | 401 | لا | يتطلب بدء الفترة التجريبية جلسة عمل مالك الحساب على وحدة التحكم. |
PRIMARY_TOKEN_INVALID | 401 | لا | جلسة عمل وحدة التحكم غير صالحة لبدء فترة تجريبية؛ قم بتسجيل الدخول مرة أخرى. |
PRIMARY_TOKEN_MISMATCH | 403 | لا | لا يمكن إلا لمالك الحساب بدء هذه الفترة التجريبية. |
ترقيم الصفحات وقابلية التكرار
Section titled “ترقيم الصفحات وقابلية التكرار”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
INVALID_CURSOR | 400 | لا | الـ cursor غير صحيح أو ينتمي إلى قائمة أخرى. |
IDEMPOTENCY_KEY_INVALID | 400 | لا | الـ Idempotency-Key رأس الرسالة غير صحيح. |
IDEMPOTENCY_KEY_REUSED | 409 | لا | الـ Idempotency-Key تم استخدام مع طلب مختلف. |
IDEMPOTENCY_IN_PROGRESS | 409 | نعم | الطلب الأول الذي يحتوي على هذا Idempotency-Key لا يزال قيد التشغيل. |
الغرف ورموز المشاركين والوسائط
Section titled “الغرف ورموز المشاركين والوسائط”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
ROOM_EXTERNAL_REF_CONFLICT | 409 | لا | تستخدم غرفة مفتوحة تابعة للمشروع هذا بالفعل externalRef. |
ROOM_FULL | 409 | لا | وصلت الغرفة إلى الحد الأقصى لعدد المشاركين. |
ROOM_LOCKED | 409 | لا | الغرفة مقفلة؛ لا يمكن الانضمام إليها إلا للمضيفين. |
ROOM_ALLOWANCE_UNAVAILABLE | 503 | نعم | تعذر قراءة الحد الأقصى لعدد المشاركين في الغرفة. |
PARTICIPANT_BANNED | 409 | لا | هذه الهوية محظورة من الغرفة. |
PARTICIPANT_REMOVED | 403 | لا | تمت إزالة هذا المشارك من الغرفة. |
MEDIA_CAPACITY | 503 | نعم | لا توجد عقدة وسائط متاحة لهذا الأمر حاليًا؛ حاول مرة أخرى لاحقًا. |
MEDIA_NODE_UNAVAILABLE | 503 | نعم | عقدة الوسائط الخاصة بالغرفة غير متاحة؛ يرجى إعادة المحاولة. |
MEDIA_UNAVAILABLE | 503 | نعم | خدمة الوسائط غير متاحة؛ يرجى إعادة المحاولة. |
HOST_MUTED | 403 | لا | قام المضيف بكتم صوت هذا المصدر. |
DATA_NOT_PERMITTED | 403 | لا | لا يجوز للمشارك إرسال رسائل التطبيق. |
MESSAGE_TOO_LARGE | 400 | لا | حجم رسالة التطبيق كبير جدًا. |
MESSAGE_RATE_LIMITED | 429 | نعم | عدد رسائل التطبيق الواردة من هذا المشارك كبير جدًّا. |
ROOM_MESSAGE_RATE_LIMITED | 429 | نعم | عدد رسائل التطبيق في هذه الغرفة كبير جدًّا. |
RESERVED_TOPIC | 400 | لا | موضوع رسالة التطبيق محجوز. |
INVALID_RECIPIENTS | 400 | لا | مستلمو رسالة التطبيق غير صالحين. |
RESUME_REFUSED | 403 | لا | لا يمكن استئناف الجلسة. |
RESUME_UNAVAILABLE | 503 | نعم | ميزة «الاستئناف» غير متاحة مؤقتًا. |
FIRST_PARTY | 409 | لا | محجوز لمنتجات الخاصة CHAMPREPبـ. |
FIRST_PARTY_NOT_READY | 503 | نعم | لم يتم تجهيز المستأجر الأصلي بعد. |
رموز الانضمام ومفاتيح توقيع المشروع
Section titled “رموز الانضمام ومفاتيح توقيع المشروع”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
JOIN_GRANT_INVALID | 401 | لا | رمز الانضمام غير صحيح الشكل، أو منتهي الصلاحية، أو موقّع بشكل خاطئ، أو تم إلغاء مفتاح التوقيع الخاص به. |
JOIN_GRANT_USED | 409 | لا | تم بالفعل استبدال رمز الانضمام هذا (فهي للاستخدام مرة واحدة فقط). |
SIGNING_KEY_LIMIT | 409 | لا | يحتوي المشروع بالفعل على العدد الأقصى من مفاتيح التوقيع النشطة. |
SIGNING_KEY_INVALID | 400 | لا | المفتاح العام ليس مفتاحًا صالحًا من نوع P-256 JWK. |
التسجيلات والنصوص المكتوبة والتعليقات الصوتية
Section titled “التسجيلات والنصوص المكتوبة والتعليقات الصوتية”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
COMPOSITE_UNAVAILABLE | 400 | لا | التسجيل المركب غير متاح. |
DELETE_NOT_AVAILABLE | 403 | لا | لا يمكن للعملاء حذف التسجيلات (لم تعد تُرسل: DELETE /v1/recordings/:id يرسل التسجيل إلى سلة المهملات، ويتم حذفه تلقائيًا بعد 30 يومًا). |
RECORDING_ACTIVE | 409 | لا | التسجيل لا يزال قيد التشغيل. |
RECORDING_SETTLING | 409 | نعم | لا يزال التسجيل قيد التخزين. |
RECORDING_NOT_READY | 409 | لا | التسجيل لم ينتهِ بعد (تحتاج عمليات التسليم إلى تسجيل جاهز). |
RECORDING_NOT_IN_TRASH | 409 | لا | لا يمكن حذف التسجيل نهائيًا إلا إذا كان موجودًا في سلة المهملات؛ قم بحذفه أولاً. |
RECORDING_PURGED | 409 | لا | تم حذف التسجيل نهائيًا (من سلة المهملات، أو بواسطة مسؤول) ولا يمكن استعادته. |
CONFIRM_PURGE_REQUIRED | 400 | لا | يتطلب تقصير نافذة «سلة المهملات» تعيين confirmPurge: true. |
TRANSCRIPTION_UNAVAILABLE | 400 | لا | النصوص غير متوفرة لهذا الحساب. |
TRANSCRIPT_EXISTS | 409 | لا | يوجد نص مكتوب لهذا التسجيل بالفعل أو أنه قيد التشغيل. |
NO_AUDIO | 409 | لا | لا يحتوي التسجيل على صوت يمكن تحويله إلى نص. |
TRANSCRIPT_NOT_READY | 409 | نعم | لم يتم الانتهاء من النص بعد؛ لا يتم تصدير سوى النصات المكتملة بتنسيقات VTT أو SRT أو TXT. |
TRANSCRIPT_RUNNING | 409 | لا | يجري إعداد النص حاليًا ولا يمكن إلغاؤه. |
TRANSCRIPT_NOT_CANCELLABLE | 409 | لا | لا يمكن إلغاء سوى النص الذي لم يبدأ بعد. |
WINDOW_TOO_LONG | 400 | لا | الفترة الزمنية المطلوبة طويلة جدًا. |
SUMMARY_TIMEOUT | 503 | نعم | استغرق الملخص وقتًا طويلاً؛ أعد المحاولة. |
CAPTIONS_BUSY | 503 | نعم | وصلت الترجمة الحية إلى سعتها القصوى؛ حاول مرة أخرى لاحقًا. |
CAPTIONS_LANGUAGE_LIMIT | 409 | لا | يوجد عدد كبير جدًا من لغات الترجمة في هذه الغرفة. |
CAPTIONS_NOT_PERMITTED | 403 | لا | قد لا يستخدم المشارك الترجمة النصية. |
INVALID_LANGUAGE | 400 | لا | رمز اللغة غير مدعوم. |
تخزين التسجيلات
Section titled “تخزين التسجيلات”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
DESTINATION_LIMIT | 409 | لا | لدى المؤسسة العدد الأقصى من وجهات التخزين. |
DESTINATION_ADMIN_DISABLED | 403 | لا | CHAMPREP قام الدعم بتعطيل وجهة التخزين هذه؛ ولا يمكن للعميل إعادة تمكينها. |
ENDPOINT_NOT_ALLOWED | 400 | لا | نقطة النهاية المتوافقة مع S3 غير مسموح بها (HTTPS على المنفذ 443 إلى عنوان عام فقط). |
REDELIVERY_LIMIT | 429 | نعم | تم إرسال التسجيل مرة أخرى مؤخرًا، أو أرسلت المؤسسة عددًا كبيرًا جدًّا مرة أخرى خلال هذه الساعة؛ حاول مرة أخرى لاحقًا. |
NO_ACTIVE_DESTINATION | 409 | لا | لا توجد وجهة تخزين نشطة مطبقة على هذا التسجيل. |
EGRESS_UNAVAILABLE | 503 | نعم | تعذر الوصول إلى نظام الفوترة لتغطية تكاليف هذا التنزيل؛ حاول مرة أخرى بعد قليل. |
DELIVERY_NOT_CONFIGURED | 503 | لا | وجهات أدوار AWS غير متاحة بعد؛ استخدم مفاتيح متوافقة مع S3 (تم إرسال الرمز والرسالة). |
CREDENTIALS_UNAVAILABLE | 503 | لا | تخزين مفاتيح الوجهة غير متاح بعد؛ استخدم دور AWS. |
Webhooks
Section titled “Webhooks”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
WEBHOOK_NOT_CONFIGURED | 409 | لا | لم يتم تكوين نقطة نهاية webhook. |
WEBHOOK_URL_INVALID | 400 | لا | عنوان URL الخاص بـ webhook ليس نقطة نهاية HTTPS عامة على المنفذ 443 خارج CHAMPREP المجالات. |
WEBHOOK_ENDPOINT_LIMIT | 409 | لا | تم الوصول إلى الحد الأقصى لعدد نقاط نهاية webhook الخاصة بالخطة (details.limit, details.used). |
WEBHOOK_ENDPOINT_NOT_FOUND | 404 | لا | نقطة نهاية webhook غير موجودة. |
WEBHOOK_ENDPOINT_DISABLED | 409 | لا | نقطة نهاية webhook معطلة؛ قم بتفعيلها أولاً. |
WEBHOOK_ENDPOINT_ADMIN_DISABLED | 403 | لا | CHAMPREP قام فريق الدعم بإيقاف تشغيل نقطة نهاية webhook؛ يرجى الاتصال بفريق الدعم. |
WEBHOOK_URL_ADMIN_DISABLED | 403 | لا | CHAMPREP قام فريق الدعم بتعطيل عنوان URL الخاص بـ webhook هذا؛ ولا يمكن إضافته مرة أخرى. اتصل بفريق الدعم. |
WEBHOOK_EVENT_UNKNOWN | 400 | لا | لا يتطابق مرشح الأحداث مع أي نوع معروف من الأحداث (details.patterns). |
REPLAY_LIMIT | 409 | لا | تم إعادة تشغيل عملية التسليم هذه عددًا كبيرًا من المرات. |
REPLAY_QUOTA | 429 | نعم | عدد الإعادة كبير جدًّا؛ انتظر حتى Retry-After ثوانٍ. |
DELIVERY_IN_PROGRESS | 409 | نعم | يتم إرسال التسليم في الوقت الحالي. |
اللوحات البيضاء
Section titled “اللوحات البيضاء”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
WHITEBOARD_UNAVAILABLE | 503 | نعم | خدمة السبورة البيضاء غير متاحة. |
WHITEBOARD_DISABLED | 403 | لا | تم تعطيل اللوحات البيضاء لهذا الحساب. |
WHITEBOARD_ARCHIVED | 409 | لا | اللوحة البيضاء مؤرشفة. |
WHITEBOARD_LIMIT | 409 | لا | تحتوي الغرفة على العدد الأقصى من اللوحات البيضاء. |
WHITEBOARD_QUOTA | 402 | لا | تم استنفاد الحصة المخصصة للسبورة البيضاء. |
WHITEBOARD_FILE_INVALID | 422 | لا | تعذر قراءة ملف السبورة البيضاء. |
WHITEBOARD_FILE_LIMIT | 409 | لا | يحتوي السبورة البيضاء على الحد الأقصى لعدد الملفات. |
WHITEBOARD_FILE_PENDING | 409 | نعم | لم يكتمل تحميل ملف السبورة البيضاء. |
WHITEBOARD_FILE_SIZE | 400 | لا | حجم الملف المعلن غير صالح. |
WHITEBOARD_FILE_TOO_LARGE | 413 | لا | حجم ملف السبورة البيضاء كبير جدًا. |
WHITEBOARD_FILE_TYPE | 415 | لا | نوع ملف السبورة البيضاء غير مسموح به. |
SNAPSHOT_TOO_LARGE | 413 | لا | لقطة السبورة البيضاء كبيرة جدًا بحيث يتعذر إرجاعها. |
التحكم عن بُعد
Section titled “التحكم عن بُعد”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
RC_BLOCKED | 403 | لا | التحكم عن بُعد محظور. |
RC_CLIPBOARD_OFF | 403 | لا | مشاركة الحافظة معطلة. |
RC_CLIPBOARD_TOO_LARGE | 413 | لا | محتوى الحافظة كبير جدًا. |
RC_CONFLICT | 409 | لا | توجد تعارضات مع طلب تحكم عن بُعد آخر. |
RC_INVALID_REQUEST | 400 | لا | طلب التحكم عن بُعد غير صالح. |
RC_NOT_PERMITTED | 403 | لا | التحكم عن بُعد غير مسموح به. |
RC_NO_BUDGET | 402 | لا | لم يتبق أي رصيد للتحكم عن بُعد. |
RC_PENDING | 409 | لا | هناك طلب تحكم عن بُعد معلق بالفعل. |
RC_RATE_LIMITED | 429 | نعم | عدد طلبات التحكم عن بُعد كبير جدًا. |
RC_REAUTH_REQUIRED | 401 | لا | أعد المصادقة لمتابعة التحكم عن بُعد. |
RC_SHARER_BUSY | 409 | لا | يتم التحكم في جهاز المشارك بالفعل. |
RC_UNAVAILABLE | 404 | لا | التحكم عن بُعد غير متاح. |
RC_WIDEN_REFUSED | 403 | لا | لا يمكن توسيع نطاق إذن التحكم عن بُعد. |
القياس عن بُعد
Section titled “القياس عن بُعد”| الرمز | HTTP | يمكن إعادة المحاولة | المعنى |
|---|---|---|---|
INVALID_TELEMETRY | 400 | لا | عينة القياس عن بُعد غير صالحة. |
TELEMETRY_RATE_LIMITED | 429 | نعم | عدد كبير جدًا من عينات القياس عن بُعد. |