公開 REST API 概要

Recho 公開 REST API は、API キーを使って参照系データをプログラムから取得するための HTTP API です。通話ログ・統計・文字起こし・音声・架電エクスポート・受電/架電の通話モニタリング（通話一覧）といったデータを、ダッシュボードを介さずに自システムへ取り込めます。

認証

すべてのエンドポイントは API キー認証が必須です。リクエストヘッダ X-API-Key に発行済みの API キーを指定します。詳細は認証 (API キー) を参照してください。

API キーには**権限（permission）**を割り当てます。各エンドポイントは特定の権限を要求し、その権限を持たない API キーからのリクエストは拒否されます。

権限は project 単位で評価されます。リクエストの projectId で指定したプロジェクトに対して、その API キーが必要な権限を持っているかどうかが判定されます。

権限 (`x-required-permission`)	説明	カテゴリ
`call-log:read`	通話ログの閲覧	通話履歴
`call-log:statistics`	通話ログの統計閲覧	通話履歴
`call-log:transcript-read`	通話の文字起こし閲覧	通話履歴
`call-log:audio-read`	通話の音声再生	通話履歴
`inbound-call:read`	受電プロジェクトの通話モニタリング閲覧	受電-通話モニタリング
`outbound-call:read`	架電プロジェクトの架電リクエスト・通話モニタリング閲覧	架電-通話モニタリング

各エンドポイントが要求する権限は、自動生成リファレンスの各エンドポイント詳細ページ（説明欄の「必要な権限」）で確認できます。

利用可能なエンドポイントの一覧・パラメータ・レスポンス構造は、左サイドバーの自動生成「API リファレンス」を参照してください。OpenAPI 仕様から自動生成されており、常に最新の公開仕様を反映します。