Frictio APIは、Frictioに蓄積されたミーティングデータをREST APIで提供します。
既存ツールとの連携やカスタムワークフローの構築、ミーティングデータからのインサイト抽出に活用できます。
- ミーティング — 商談・通話の一覧取得、日時・種別・参加者によるフィルタリング
- サマリー・アクションアイテム — ミーティングごとのチャプター別要約とアクションアイテムの取得
- 文字起こし — 話者ごとの発言テキスト(ワードレベルのタイミング情報付き)
- CRM連携 — HubSpot / Salesforce と同期されたレコード情報の参照
すべてのリクエストに以下の2つのヘッダーを含めてください。
| ヘッダー | 説明 |
|---|
X-Api-Key | 認証用APIキー |
X-Workspace-Id | 対象ワークスペースのID |
APIキーの取得
アドミン・ビューワーアドミンのワークスペースメンバーは、Frictio Web Appの管理者向けの設定ページからAPIキーを発行することができます。
APIキーは発行時に一度だけ表示されます。安全に保管してください。
レート制限
制限を超えた場合は 429 Too Many Requests が返されます。しばらく待ってからリトライしてください。
ページネーション
一覧エンドポイントはカーソルベースのページネーションを採用しています。
| パラメータ | 型 | デフォルト | 説明 |
|---|
limit | integer | 30 | 1ページあたりの取得件数(1–50) |
cursor | string | — | 前回レスポンスの next_cursor |
{
"data": [...],
"pagination": {
"next_cursor": "eyJpZCI6MTIzfQ=="
}
}
next_cursor が null の場合、次のページはありません。
エラー
| ステータス | 説明 |
|---|
401 | APIキーが無効または未指定 |
403 | 対象リソースへのアクセス権限がない |
404 | 指定されたリソースが存在しない |
429 | レート制限超過 |
エラーレスポンスは以下の形式で返されます。
{
"code": "NOT_FOUND",
"message": "Meeting not found"
}