API リファレンス

リファレンス

エラーリファレンス

失敗時は HTTP ステータスを確認し、error.code または 5 桁の error.numeric_code で原因を判断します。error.message は表示用で、プログラムの分岐には使いません。調査のため request_id を保存してください。

400 Bad Request

  • invalid_request10000

    JSON 本文と必須項目を確認してください。

  • invalid_provider30000

    URL のチャネル識別子を確認してください。

  • unsupported_action30005

    認識できないアカウント操作です。文書化された操作を使ってください。

  • invalid_conversation_type37000

    type は user、group、channel のいずれかです。

  • unsupported_conversation_type37001

    チャネルが未対応です。対応表から利用可能な操作を選んでください。

  • unsupported_message_type36000

    チャネルが対応する message.type を使ってください。

  • unsupported_provider_auth_mode20018

    チャネルが対応する auth_mode を使ってください。

  • auth_mode_phone_required20019

    この方式ではアカウント作成時に provider_data.phone が必要です。

  • invalid_reply_token36006

    引用トークンを読み取れません。受信イベントの data.message.reply_token をそのまま使ってください。

  • provider_invalid_request30001

    チャネル固有の項目と形式を確認してください。

  • create_api_key_failed11101

    操作が拒否されました。リクエストを確認し、request_id を保存してください。

  • update_api_key_failed11102

    操作が拒否されました。リクエストを確認し、request_id を保存してください。

  • rotate_api_key_failed11103

    操作が拒否されました。リクエストを確認し、request_id を保存してください。

  • update_workspace_failed41001

    操作が拒否されました。リクエストを確認し、request_id を保存してください。

401 Unauthorized

  • missing_api_key11000

    X-Api-Key ヘッダーを追加してください。

  • invalid_api_key11001

    API Key が正しく有効か確認してください。

403 Forbidden

  • cors_forbidden11009

    CORS のオリジン、メソッド、ヘッダーが許可されていません。呼び出し環境を確認してください。

404 Not Found

  • not_found10001

    API パスと HTTP メソッドを確認してください。

  • conversation_not_found37002

    チャネルで会話が見つかりません。識別子とアカウントを確認してください。

  • contact_not_found35000

    このアカウントで連絡先が見つかりません。識別子を確認してください。

  • group_not_found34004

    このアカウントでグループが見つかりません。グループ ID を確認してください。

409 Conflict

  • account_allocation_busy20011

    アカウントの割り当て処理中です。少し待って再試行してください。

  • no_allocatable_server20013

    このリージョンに空きがありません。割り当て可能な別のリージョンを確認してください。

  • workspace_account_quota_exceeded20014

    メッセージングアカウント数が上限に達しています。使用数と上限を確認してください。

  • duplicate_provider_account20015

    同じチャネルのアカウントがこのワークスペース内ですでに接続されています。

  • account_already_authorized20016

    認可済みです。そのアカウントを使うか、新しい認可の前に現在の認可を解除してください。

  • account_binding_not_found30006

    有効なチャネル接続への紐付けがありません。アカウントの状態を確認してください。

  • provider_account_mismatch20017

    指定したチャネルの識別情報がアカウントの紐付けと一致しません。

  • provider_not_ready30009

    接続が未準備です。認可と runtime_status を確認してから再試行を判断してください。

422 Unprocessable Entity

  • contact_not_found35000

    GET /contacts/info が Conversation not found を返しました。対象の識別子と照会アカウントを確認してください。

500 Internal Server Error

  • create_account_failed20002

    アカウント作成: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • update_account_failed20003

    アカウント更新: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • delete_account_failed20004

    アカウント削除: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_account_failed20001

    アカウント取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_accounts_failed20000

    アカウント一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_session_failed20005

    認証ステータス取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_auth_state_failed20006

    認証ステータス取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • run_action_failed20007

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • run_runtime_action_failed20008

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • run_session_action_failed20009

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • run_auth_action_failed20010

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • send_message_failed36001

    テキストメッセージ送信: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • pin_message_failed36002

    メッセージのピン留め / 解除: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • revoke_message_failed36003

    メッセージの取り消し: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • react_message_failed36004

    メッセージへのリアクション: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • edit_message_failed36005

    メッセージの編集: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_conversations_failed37003

    会話一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_conversation_failed37004

    会話の詳細: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_conversation_members_failed37005

    会話メンバー一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • mark_conversation_read_failed37006

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • mark_conversation_unread_failed37007

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • mute_conversation_failed37008

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • unmute_conversation_failed37009

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • pin_conversation_failed37010

    会話のピン留め: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • unpin_conversation_failed37011

    会話のピン留め解除: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_conversation_labels_failed37012

    会話ラベル一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • upsert_label_failed37013

    ラベルの作成または更新: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • delete_label_failed37014

    ラベルの削除: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • set_label_members_failed37015

    会話へのラベルの追加 / 削除: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_contacts_failed35001

    連絡先一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_contact_failed35002

    連絡先取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • create_contact_failed35003

    連絡先を追加: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_contact_membership_failed35004

    連絡先リスト所属を確認: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • block_contact_failed35005

    連絡先のブロック: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • unblock_contact_failed35006

    連絡先のブロック解除: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_blocklist_failed35007

    ブロックリスト取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • set_contact_note_failed35008

    連絡先メモの設定: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_groups_failed34000

    グループ一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_group_failed34001

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • create_group_failed34002

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • leave_group_failed34003

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • update_group_members_failed34005

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • update_group_info_failed34006

    グループ情報の更新: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_group_join_requests_failed34007

    参加リクエスト一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • update_group_join_requests_failed34008

    参加リクエストの承認 / 拒否: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • set_group_join_approval_mode_failed34009

    参加承認モードの設定: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_group_invite_code_failed34010

    グループ招待リンク取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_webhook_endpoints_failed40000

    サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • create_webhook_endpoint_failed40001

    Webhook エンドポイント作成: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_webhook_endpoint_failed40002

    Webhook エンドポイント取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • update_webhook_endpoint_failed40003

    Webhook エンドポイント更新: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • deactivate_webhook_endpoint_failed40004

    Webhook エンドポイントを停止: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • delete_webhook_endpoint_failed40005

    Webhook エンドポイント削除: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • get_workspace_failed41000

    現在の Workspace を取得: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_api_keys_failed11100

    API キー一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

  • list_provider_regions_failed30011

    プロバイダのリージョン一覧: サービスまたはチャネルが操作を完了できませんでした。request_id を保存し、書き込みの再試行前に前回の結果を確認してください。

501 Not Implemented

  • unsupported_by_provider30003

    チャネルが未対応です。対応表から利用可能な操作を選んでください。

502 Bad Gateway

  • provider_adapter_not_found30004

    チャネルサービスを利用できません。状態を確認するか後で再試行してください。書き込みは前回の結果を先に確認してください。

  • provider_unavailable30002

    チャネルサービスを利用できません。状態を確認するか後で再試行してください。書き込みは前回の結果を先に確認してください。

503 Service Unavailable

  • allocation_service_unavailable20012

    割り当てサービスを一時的に利用できません。後で再試行してください。

Provider 詳細 numeric code

元の HTTP ステータスや legacy code を変えずに Provider の原因を細分化します。

  • provider_operation_failed30010

    Provider operation failed

    チャネルが操作を完了できませんでした。調査用に request_id を保存してください。

  • group_not_found34004

    Group not found

    グループが見つかりません。一部の既存 API では元の HTTP ステータスと error.code を維持します。

  • group_not_participant34011

    Account is not participating in this group

    グループが存在していても、このアカウントが参加していない場合があります。