RTCエラー
すべての RTC エラーには、安定した、機械可読な code。 メッセージ本文ではなく、コードを基準にしてください。メッセージは言い回しが変更される可能性がありますが、コードは 名前が変更されたり、別の意味で再利用されたりすることはありません。
2つのレスポンス形式
Section titled “2つのレスポンス形式”デフォルト。 バージョンヘッダーがない場合、エラーは元の形式を維持するため、 既存の統合には影響がありません:
{ "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 | このリクエストのID。以下としても送信されます。 X-Request-Id |
retryable | true 後で同じリクエストを再試行すると成功する場合があります |
docUrl | 以下のこのコードのエントリへのリンク |
レスポンスには、適用されたバージョンが反映されます。 RTC-Version ヘッダー。日付 以前 2026-11-01 はデフォルトの形式を維持します。詳しくは バージョン管理.
すべてのレスポンスに含まれるヘッダー
Section titled “すべてのレスポンスに含まれるヘッダー”| ヘッダー | いつ | 意味 |
|---|---|---|
X-Request-Id | すべてのレスポンス | リクエストの一意の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ステータスごとに1つ、特定のコードが適用されない場合に使用されます)
Section titled “汎用コード(HTTPステータスごとに1つ、特定のコードが適用されない場合に使用されます)”| コード | 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 (解決策:トライアル、サブスクリプション、アップグレード、パック、または カードの追加。それぞれに「CHAMPREPBilling」リンクがあります)また、特定の利用枠や機能を指す場合は、 feature.
| コード | HTTP | 再試行可能 | 意味 |
|---|---|---|---|
RTC_SUBSCRIPTION_REQUIRED | 402 | いいえ | このアカウントには、RTCのサブスクリプション、トライアル、または付属の割り当てがありません(参照 offers). |
RTC_PAYMENT_REQUIRED | 402 | いいえ | 未払いの請求書があるとRTCが利用できなくなります。BillingCHAMPREPで支払ってください。 |
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 | いいえ | このIDは、このルームから利用禁止となっています。 |
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 | いいえ | この参加トークンはすでに使用済みです(1回限りの使用となります)。 |
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互換のエンドポイントは許可されていません(443番ポートのHTTPSで、パブリックアドレスへの接続のみ)。 |
REDELIVERY_LIMIT | 429 | はい | この録音は最近再度送信されたか、またはこの1時間に組織から送信された数が多すぎます。後ほど再試行してください。 |
NO_ACTIVE_DESTINATION | 409 | いいえ | この録音に適用されるアクティブな保存先がありません。 |
EGRESS_UNAVAILABLE | 503 | はい | このダウンロードにかかる請求先と連絡が取れませんでした。しばらくしてから再度お試しください。 |
DELIVERY_NOT_CONFIGURED | 503 | いいえ | AWS ロールの保存先はまだ利用できません。S3 互換のキーをご利用ください(コードとメッセージが送信されています)。 |
CREDENTIALS_UNAVAILABLE | 503 | いいえ | 保存先キーの保存機能はまだ利用できません。AWSロールをご利用ください。 |
Webhook
Section titled “Webhook”| コード | HTTP | 再試行可能 | 意味 |
|---|---|---|---|
WEBHOOK_NOT_CONFIGURED | 409 | いいえ | Webhookエンドポイントが設定されていません。 |
WEBHOOK_URL_INVALID | 400 | いいえ | Webhook URL は、ドメインCHAMPREP外のポート 443 にある公開 HTTPS エンドポイントではありません。 |
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 サポートチームがこの Webhook URL を無効にしました。再度追加することはできません。サポートチームにお問い合わせください。 |
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 | いいえ | リモートコントロールの許可範囲を拡大できません。 |
| コード | HTTP | 再試行可能 | 意味 |
|---|---|---|---|
INVALID_TELEMETRY | 400 | いいえ | テレメトリのサンプルは無効です。 |
TELEMETRY_RATE_LIMITED | 429 | はい | テレメトリのサンプル数が多すぎます。 |