コンテンツにスキップ
Documentation

RTCエラー

すべての RTC エラーには、安定した、機械可読な code。 メッセージ本文ではなく、コードを基準にしてください。メッセージは言い回しが変更される可能性がありますが、コードは 名前が変更されたり、別の意味で再利用されたりすることはありません。

デフォルト。 バージョンヘッダーがない場合、エラーは元の形式を維持するため、 既存の統合には影響がありません:

{ "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このリクエストのID。以下としても送信されます。 X-Request-Id
retryabletrue 後で同じリクエストを再試行すると成功する場合があります
docUrl以下のこのコードのエントリへのリンク

レスポンスには、適用されたバージョンが反映されます。 RTC-Version ヘッダー。日付 以前 2026-11-01 はデフォルトの形式を維持します。詳しくは バージョン管理.

すべてのレスポンスに含まれるヘッダー

Section titled “すべてのレスポンスに含まれるヘッダー”
ヘッダーいつ意味
X-Request-Idすべてのレスポンスリクエストの一意の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ステータスごとに1つ、特定のコードが適用されない場合に使用されます)

Section titled “汎用コード(HTTPステータスごとに1つ、特定のコードが適用されない場合に使用されます)”
コード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 (解決策:トライアル、サブスクリプション、アップグレード、パック、または カードの追加。それぞれに「CHAMPREPBilling」リンクがあります)また、特定の利用枠や機能を指す場合は、 feature.

コードHTTP再試行可能意味
RTC_SUBSCRIPTION_REQUIRED402いいえこのアカウントには、RTCのサブスクリプション、トライアル、または付属の割り当てがありません(参照 offers).
RTC_PAYMENT_REQUIRED402いいえ未払いの請求書があるとRTCが利用できなくなります。BillingCHAMPREPで支払ってください。
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いいえこのトライアルを開始できるのは、アカウント所有者のみです。

コード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いいえこのIDは、このルームから利用禁止となっています。
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いいえこの参加トークンはすでに使用済みです(1回限りの使用となります)。
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互換のエンドポイントは許可されていません(443番ポートのHTTPSで、パブリックアドレスへの接続のみ)。
REDELIVERY_LIMIT429はいこの録音は最近再度送信されたか、またはこの1時間に組織から送信された数が多すぎます。後ほど再試行してください。
NO_ACTIVE_DESTINATION409いいえこの録音に適用されるアクティブな保存先がありません。
EGRESS_UNAVAILABLE503はいこのダウンロードにかかる請求先と連絡が取れませんでした。しばらくしてから再度お試しください。
DELIVERY_NOT_CONFIGURED503いいえAWS ロールの保存先はまだ利用できません。S3 互換のキーをご利用ください(コードとメッセージが送信されています)。
CREDENTIALS_UNAVAILABLE503いいえ保存先キーの保存機能はまだ利用できません。AWSロールをご利用ください。

コードHTTP再試行可能意味
WEBHOOK_NOT_CONFIGURED409いいえWebhookエンドポイントが設定されていません。
WEBHOOK_URL_INVALID400いいえWebhook URL は、ドメインCHAMPREP外のポート 443 にある公開 HTTPS エンドポイントではありません。
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 サポートチームがこの Webhook URL を無効にしました。再度追加することはできません。サポートチームにお問い合わせください。
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はいテレメトリのサンプル数が多すぎます。