تخطَّ إلى المحتوى
Documentation

أخطاء RTC

كل خطأ في RTC يحمل رمزًا ثابتًا وقابلًا للقراءة آليًا الرمز. قم بتفعيل الرمز، وليس نص الرسالة أبدًا: فقد يتم إعادة صياغة الرسائل، أما الرموز فلا يتم إعادة تسميتها أو إعادة استخدامها بمعنى آخر أبدًا.

الافتراضي. بدون رأس الإصدار، تحتفظ الأخطاء بشكلها الأصلي، وبالتالي لا تتأثر عمليات التكامل الحالية:

{ "error": "Your plan allows 2 webhook endpoints", "code": "WEBHOOK_ENDPOINT_LIMIT" }

code يظهر في الأخطاء التي لها رمز محدد. قد تحمل الأخطاء القديمة فقط error؛ X-Error-Code يحدد الرأس دائمًا اسم الرمز.

مغلف منظم. إرسال RTC-Version: 2026-11-01 مع طلب للحصول على المغلف المنظم:

Terminal window
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
retryabletrue عند إعادة محاولة نفس الطلب لاحقًا قد تنجح
docUrlرابط إلى مدخل هذا الرمز أدناه

يعكس الرد الإصدار الذي تم تطبيقه في RTC-Version . تاريخ قبل 2026-11-01 يحتفظ بالشكل الافتراضي. انظر إصدارات.

رأس الرسالةمتىالمعنى
X-Request-Idكل استجابةالمعرف الفريد للطلب. قم بتضمينه عند الاتصال بالدعم الفني.
X-Error-Codeكل خطأالرمز الثابت، في كلا شكلي الاستجابة
Retry-After429، وبعض 503عدد الثواني التي يجب الانتظار قبل إعادة المحاولة
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Resetالردود المصادق عليهاانظر حدود المعدل

  • retryable: false (4xx بخلاف 429): قم أولاً بتصحيح الطلب أو بيانات الاعتماد أو الخطة أو الحالة. إن تكرار الطلب دون تغيير يؤدي إلى الحصول على نفس الإجابة.
  • retryable: true: أعد المحاولة مع التراجع الأسي والتذبذب، مع مراعاة Retry-After. أعد المحاولة للكتابة فقط عندما تكون العملية متجانسة أو بعد تسوية نتيجتها.
  • 401: بيانات الاعتماد مفقودة أو منتهية الصلاحية أو تم إلغاؤها. 403: بيانات الاعتماد صالحة ولكنها تفتقر إلى نطاق أو وصول إلى المشروع أو حق الاستفادة من الخطة.
  • 404 يشمل أيضًا الموارد التي تخص شخصًا آخر. لا تقم أبدًا بالتحقق من معرفات العملاء الآخرين.

GET /v1/error-codes (بدون مصادقة) يعرض الكتالوج الحالي على النحو التالي: { "codes": [{ "code", "status", "retryable", "description" }] }. قد تُضاف رموز جديدة في أي وقت؛ تعامل مع الرمز غير المعروف كأنه الرمز العام لحالة HTTP الخاصة به.

الرموز العامة (رمز واحد لكل حالة HTTP، تُستخدم عندما لا ينطبق أي رمز محدد)

Section titled “الرموز العامة (رمز واحد لكل حالة HTTP، تُستخدم عندما لا ينطبق أي رمز محدد)”
الرمزHTTPيمكن إعادة المحاولةالمعنى
INVALID_REQUEST400لاالطلب غير صحيح أو أحد الحقول غير صالح (details.issues تسرد الحقول).
UNAUTHENTICATED401لابيانات اعتماد مفقودة أو غير صالحة أو منتهية الصلاحية.
PAYMENT_REQUIRED402لايجب سداد دفعة مستحقة قبل أن يمكن استخدام هذه الخدمة.
FORBIDDEN403لابيانات الاعتماد صالحة ولكن غير مسموح لها بالقيام بذلك.
NOT_FOUND404لاالمورد غير موجود أو غير مرئي لهذه البيانات الاعتمادية.
CONFLICT409لايتعارض الطلب مع الحالة الحالية.
PAYLOAD_TOO_LARGE413لاحجم نص الطلب كبير جدًا.
UNSUPPORTED_MEDIA_TYPE415لانوع المحتوى غير مقبول.
RANGE_NOT_SATISFIABLE416لانطاق البايت المطلوب غير صالح أو غير متاح.
UNPROCESSABLE422لاتم فهم المحتوى ولكن لا يمكن معالجته.
RATE_LIMITED429نعمعدد الطلبات زائد؛ انتظر حتى Retry-After ثوانٍ.
INTERNAL500نعمخطأ غير متوقع في الخادم؛ أعد المحاولة لاحقًا.
SERVICE_UNAVAILABLE503نعمغير متاح مؤقتًا؛ أعد المحاولة مع التراجع.

تتضمن هذه الإجابات أيضًا offers (كيفية حل المشكلة: إصدار نسخة تجريبية، أو الاشتراك، أو الترقية، أو حزمة، أو إضافة بطاقة، وكل منها يحتوي على رابط CHAMPREP«Billing») وفي الحالات التي يُقصد فيها حد معين أو ميزة معينة، feature.

الرمزHTTPيمكن إعادة المحاولةالمعنى
RTC_SUBSCRIPTION_REQUIRED402لالا يحتوي الحساب على اشتراك في RTC أو نسخة تجريبية أو رصيد مضمن (انظر offers).
RTC_PAYMENT_REQUIRED402لاتؤدي الفاتورة غير المدفوعة إلى حظر خدمة RTC؛ قم بسدادها في CHAMPREP الفوترة.
RTC_ACCESS_DENIED403لاسياسة المؤسسة أو الفريق أو المنصة تمنع RTC (reasonCode (يحدد أي منها).
RTC_ALLOWANCE_EXHAUSTED402لاتم استنفاد رصيد RTC الخاص بالاشتراك (feature يحدد أي منها؛ انظر offers).
RTC_FEATURE_NOT_IN_PLAN403لالا يشمل الاشتراك هذه الميزة (انظر offers).
RTC_PLAN_LIMIT403لاتم الوصول إلى حد الاشتراك (حجم الغرفة، الغرف المفتوحة في نفس الوقت).
PAYMENT_METHOD_REQUIRED402لاتتطلب النسخة التجريبية وجود بطاقة محفوظة في مساحة العمل المدفوعة (انظر offers).
TRIAL_ALREADY_USED409لاتم استخدام الإصدار التجريبي المجاني بالفعل من قبل هذا الحساب.
TRIAL_NOT_ALLOWED403لالا يمكن لهذا الحساب بدء الإصدار التجريبي المجاني.
TRIAL_UNAVAILABLE409لاالإصدار التجريبي المجاني غير متاح.
ALREADY_SUBSCRIBED409لايحتوي الحساب بالفعل على اشتراك RTC.
PRIMARY_TOKEN_REQUIRED401لايتطلب بدء الفترة التجريبية جلسة عمل مالك الحساب على وحدة التحكم.
PRIMARY_TOKEN_INVALID401لاجلسة عمل وحدة التحكم غير صالحة لبدء فترة تجريبية؛ قم بتسجيل الدخول مرة أخرى.
PRIMARY_TOKEN_MISMATCH403لالا يمكن إلا لمالك الحساب بدء هذه الفترة التجريبية.

ترقيم الصفحات وقابلية التكرار

Section titled “ترقيم الصفحات وقابلية التكرار”
الرمزHTTPيمكن إعادة المحاولةالمعنى
INVALID_CURSOR400لاالـ cursor غير صحيح أو ينتمي إلى قائمة أخرى.
IDEMPOTENCY_KEY_INVALID400لاالـ Idempotency-Key رأس الرسالة غير صحيح.
IDEMPOTENCY_KEY_REUSED409لاالـ Idempotency-Key تم استخدام مع طلب مختلف.
IDEMPOTENCY_IN_PROGRESS409نعمالطلب الأول الذي يحتوي على هذا Idempotency-Key لا يزال قيد التشغيل.

الغرف ورموز المشاركين والوسائط

Section titled “الغرف ورموز المشاركين والوسائط”
الرمزHTTPيمكن إعادة المحاولةالمعنى
ROOM_EXTERNAL_REF_CONFLICT409لاتستخدم غرفة مفتوحة تابعة للمشروع هذا بالفعل externalRef.
ROOM_FULL409لاوصلت الغرفة إلى الحد الأقصى لعدد المشاركين.
ROOM_LOCKED409لاالغرفة مقفلة؛ لا يمكن الانضمام إليها إلا للمضيفين.
ROOM_ALLOWANCE_UNAVAILABLE503نعمتعذر قراءة الحد الأقصى لعدد المشاركين في الغرفة.
PARTICIPANT_BANNED409لاهذه الهوية محظورة من الغرفة.
PARTICIPANT_REMOVED403لاتمت إزالة هذا المشارك من الغرفة.
MEDIA_CAPACITY503نعملا توجد عقدة وسائط متاحة لهذا الأمر حاليًا؛ حاول مرة أخرى لاحقًا.
MEDIA_NODE_UNAVAILABLE503نعمعقدة الوسائط الخاصة بالغرفة غير متاحة؛ يرجى إعادة المحاولة.
MEDIA_UNAVAILABLE503نعمخدمة الوسائط غير متاحة؛ يرجى إعادة المحاولة.
HOST_MUTED403لاقام المضيف بكتم صوت هذا المصدر.
DATA_NOT_PERMITTED403لالا يجوز للمشارك إرسال رسائل التطبيق.
MESSAGE_TOO_LARGE400لاحجم رسالة التطبيق كبير جدًا.
MESSAGE_RATE_LIMITED429نعمعدد رسائل التطبيق الواردة من هذا المشارك كبير جدًّا.
ROOM_MESSAGE_RATE_LIMITED429نعمعدد رسائل التطبيق في هذه الغرفة كبير جدًّا.
RESERVED_TOPIC400لاموضوع رسالة التطبيق محجوز.
INVALID_RECIPIENTS400لامستلمو رسالة التطبيق غير صالحين.
RESUME_REFUSED403لالا يمكن استئناف الجلسة.
RESUME_UNAVAILABLE503نعمميزة «الاستئناف» غير متاحة مؤقتًا.
FIRST_PARTY409لامحجوز لمنتجات الخاصة CHAMPREPبـ.
FIRST_PARTY_NOT_READY503نعملم يتم تجهيز المستأجر الأصلي بعد.

رموز الانضمام ومفاتيح توقيع المشروع

Section titled “رموز الانضمام ومفاتيح توقيع المشروع”
الرمزHTTPيمكن إعادة المحاولةالمعنى
JOIN_GRANT_INVALID401لارمز الانضمام غير صحيح الشكل، أو منتهي الصلاحية، أو موقّع بشكل خاطئ، أو تم إلغاء مفتاح التوقيع الخاص به.
JOIN_GRANT_USED409لاتم بالفعل استبدال رمز الانضمام هذا (فهي للاستخدام مرة واحدة فقط).
SIGNING_KEY_LIMIT409لايحتوي المشروع بالفعل على العدد الأقصى من مفاتيح التوقيع النشطة.
SIGNING_KEY_INVALID400لاالمفتاح العام ليس مفتاحًا صالحًا من نوع P-256 JWK.

التسجيلات والنصوص المكتوبة والتعليقات الصوتية

Section titled “التسجيلات والنصوص المكتوبة والتعليقات الصوتية”
الرمزHTTPيمكن إعادة المحاولةالمعنى
COMPOSITE_UNAVAILABLE400لاالتسجيل المركب غير متاح.
DELETE_NOT_AVAILABLE403لالا يمكن للعملاء حذف التسجيلات (لم تعد تُرسل: DELETE /v1/recordings/:id يرسل التسجيل إلى سلة المهملات، ويتم حذفه تلقائيًا بعد 30 يومًا).
RECORDING_ACTIVE409لاالتسجيل لا يزال قيد التشغيل.
RECORDING_SETTLING409نعملا يزال التسجيل قيد التخزين.
RECORDING_NOT_READY409لاالتسجيل لم ينتهِ بعد (تحتاج عمليات التسليم إلى تسجيل جاهز).
RECORDING_NOT_IN_TRASH409لالا يمكن حذف التسجيل نهائيًا إلا إذا كان موجودًا في سلة المهملات؛ قم بحذفه أولاً.
RECORDING_PURGED409لاتم حذف التسجيل نهائيًا (من سلة المهملات، أو بواسطة مسؤول) ولا يمكن استعادته.
CONFIRM_PURGE_REQUIRED400لايتطلب تقصير نافذة «سلة المهملات» تعيين confirmPurge: true.
TRANSCRIPTION_UNAVAILABLE400لاالنصوص غير متوفرة لهذا الحساب.
TRANSCRIPT_EXISTS409لايوجد نص مكتوب لهذا التسجيل بالفعل أو أنه قيد التشغيل.
NO_AUDIO409لالا يحتوي التسجيل على صوت يمكن تحويله إلى نص.
TRANSCRIPT_NOT_READY409نعملم يتم الانتهاء من النص بعد؛ لا يتم تصدير سوى النصات المكتملة بتنسيقات VTT أو SRT أو TXT.
TRANSCRIPT_RUNNING409لايجري إعداد النص حاليًا ولا يمكن إلغاؤه.
TRANSCRIPT_NOT_CANCELLABLE409لالا يمكن إلغاء سوى النص الذي لم يبدأ بعد.
WINDOW_TOO_LONG400لاالفترة الزمنية المطلوبة طويلة جدًا.
SUMMARY_TIMEOUT503نعماستغرق الملخص وقتًا طويلاً؛ أعد المحاولة.
CAPTIONS_BUSY503نعموصلت الترجمة الحية إلى سعتها القصوى؛ حاول مرة أخرى لاحقًا.
CAPTIONS_LANGUAGE_LIMIT409لايوجد عدد كبير جدًا من لغات الترجمة في هذه الغرفة.
CAPTIONS_NOT_PERMITTED403لاقد لا يستخدم المشارك الترجمة النصية.
INVALID_LANGUAGE400لارمز اللغة غير مدعوم.

الرمزHTTPيمكن إعادة المحاولةالمعنى
DESTINATION_LIMIT409لالدى المؤسسة العدد الأقصى من وجهات التخزين.
DESTINATION_ADMIN_DISABLED403لاCHAMPREP قام الدعم بتعطيل وجهة التخزين هذه؛ ولا يمكن للعميل إعادة تمكينها.
ENDPOINT_NOT_ALLOWED400لانقطة النهاية المتوافقة مع S3 غير مسموح بها (HTTPS على المنفذ 443 إلى عنوان عام فقط).
REDELIVERY_LIMIT429نعمتم إرسال التسجيل مرة أخرى مؤخرًا، أو أرسلت المؤسسة عددًا كبيرًا جدًّا مرة أخرى خلال هذه الساعة؛ حاول مرة أخرى لاحقًا.
NO_ACTIVE_DESTINATION409لالا توجد وجهة تخزين نشطة مطبقة على هذا التسجيل.
EGRESS_UNAVAILABLE503نعمتعذر الوصول إلى نظام الفوترة لتغطية تكاليف هذا التنزيل؛ حاول مرة أخرى بعد قليل.
DELIVERY_NOT_CONFIGURED503لاوجهات أدوار AWS غير متاحة بعد؛ استخدم مفاتيح متوافقة مع S3 (تم إرسال الرمز والرسالة).
CREDENTIALS_UNAVAILABLE503لاتخزين مفاتيح الوجهة غير متاح بعد؛ استخدم دور AWS.
الرمزHTTPيمكن إعادة المحاولةالمعنى
WEBHOOK_NOT_CONFIGURED409لالم يتم تكوين نقطة نهاية webhook.
WEBHOOK_URL_INVALID400لاعنوان URL الخاص بـ webhook ليس نقطة نهاية HTTPS عامة على المنفذ 443 خارج CHAMPREP المجالات.
WEBHOOK_ENDPOINT_LIMIT409لاتم الوصول إلى الحد الأقصى لعدد نقاط نهاية webhook الخاصة بالخطة (details.limit, details.used).
WEBHOOK_ENDPOINT_NOT_FOUND404لانقطة نهاية webhook غير موجودة.
WEBHOOK_ENDPOINT_DISABLED409لانقطة نهاية webhook معطلة؛ قم بتفعيلها أولاً.
WEBHOOK_ENDPOINT_ADMIN_DISABLED403لاCHAMPREP قام فريق الدعم بإيقاف تشغيل نقطة نهاية webhook؛ يرجى الاتصال بفريق الدعم.
WEBHOOK_URL_ADMIN_DISABLED403لاCHAMPREP قام فريق الدعم بتعطيل عنوان URL الخاص بـ webhook هذا؛ ولا يمكن إضافته مرة أخرى. اتصل بفريق الدعم.
WEBHOOK_EVENT_UNKNOWN400لالا يتطابق مرشح الأحداث مع أي نوع معروف من الأحداث (details.patterns).
REPLAY_LIMIT409لاتم إعادة تشغيل عملية التسليم هذه عددًا كبيرًا من المرات.
REPLAY_QUOTA429نعمعدد الإعادة كبير جدًّا؛ انتظر حتى Retry-After ثوانٍ.
DELIVERY_IN_PROGRESS409نعميتم إرسال التسليم في الوقت الحالي.

الرمزHTTPيمكن إعادة المحاولةالمعنى
WHITEBOARD_UNAVAILABLE503نعمخدمة السبورة البيضاء غير متاحة.
WHITEBOARD_DISABLED403لاتم تعطيل اللوحات البيضاء لهذا الحساب.
WHITEBOARD_ARCHIVED409لااللوحة البيضاء مؤرشفة.
WHITEBOARD_LIMIT409لاتحتوي الغرفة على العدد الأقصى من اللوحات البيضاء.
WHITEBOARD_QUOTA402لاتم استنفاد الحصة المخصصة للسبورة البيضاء.
WHITEBOARD_FILE_INVALID422لاتعذر قراءة ملف السبورة البيضاء.
WHITEBOARD_FILE_LIMIT409لايحتوي السبورة البيضاء على الحد الأقصى لعدد الملفات.
WHITEBOARD_FILE_PENDING409نعملم يكتمل تحميل ملف السبورة البيضاء.
WHITEBOARD_FILE_SIZE400لاحجم الملف المعلن غير صالح.
WHITEBOARD_FILE_TOO_LARGE413لاحجم ملف السبورة البيضاء كبير جدًا.
WHITEBOARD_FILE_TYPE415لانوع ملف السبورة البيضاء غير مسموح به.
SNAPSHOT_TOO_LARGE413لالقطة السبورة البيضاء كبيرة جدًا بحيث يتعذر إرجاعها.

الرمزHTTPيمكن إعادة المحاولةالمعنى
RC_BLOCKED403لاالتحكم عن بُعد محظور.
RC_CLIPBOARD_OFF403لامشاركة الحافظة معطلة.
RC_CLIPBOARD_TOO_LARGE413لامحتوى الحافظة كبير جدًا.
RC_CONFLICT409لاتوجد تعارضات مع طلب تحكم عن بُعد آخر.
RC_INVALID_REQUEST400لاطلب التحكم عن بُعد غير صالح.
RC_NOT_PERMITTED403لاالتحكم عن بُعد غير مسموح به.
RC_NO_BUDGET402لالم يتبق أي رصيد للتحكم عن بُعد.
RC_PENDING409لاهناك طلب تحكم عن بُعد معلق بالفعل.
RC_RATE_LIMITED429نعمعدد طلبات التحكم عن بُعد كبير جدًا.
RC_REAUTH_REQUIRED401لاأعد المصادقة لمتابعة التحكم عن بُعد.
RC_SHARER_BUSY409لايتم التحكم في جهاز المشارك بالفعل.
RC_UNAVAILABLE404لاالتحكم عن بُعد غير متاح.
RC_WIDEN_REFUSED403لالا يمكن توسيع نطاق إذن التحكم عن بُعد.

الرمزHTTPيمكن إعادة المحاولةالمعنى
INVALID_TELEMETRY400لاعينة القياس عن بُعد غير صالحة.
TELEMETRY_RATE_LIMITED429نعمعدد كبير جدًا من عينات القياس عن بُعد.