Introduction - Frictio Public API

Frictio Public APIは現在ベータ版のため、スキーマやエンドポイントの仕様が変更される可能性があります。

Frictio Public APIは、Frictioに蓄積されたミーティングデータをREST APIで提供します。既存ツールとの連携やカスタムワークフローの構築、ミーティングデータからのインサイト抽出に活用できます。

認証

すべてのリクエストに以下の2つのヘッダーを含めてください。

ヘッダー	説明
`X-Api-Key`	認証用APIキー
`X-Workspace-Id`	対象ワークスペースのID

アドミン・ビューワーアドミンのワークスペースメンバーは、Frictio Web Appの管理者向けの設定ページからAPIキーを発行することができます。

APIキーは発行時に一度だけ表示されます。安全に保管してください。

エンドポイント	リクエスト上限
`GET /v1/meetings`	100リクエスト/分
`GET /v1/meetings/{meetingId}`	100リクエスト/分
`GET /v1/meetings/{meetingId}/transcript`	5リクエスト/分

上記の制限はワークスペースごとに適用され、エンドポイント間で共有されません。制限を超えた場合は 429 Too Many Requests が返されます。しばらく待ってからリトライしてください。

一覧エンドポイントはカーソルベースのページネーションを採用しています。

パラメータ	型	デフォルト	説明
`limit`	integer	30	1ページあたりの取得件数（1–50）
`cursor`	string	—	前回レスポンスの `next_cursor`

{
  "data": [...],
  "pagination": {
    "next_cursor": "eyJpZCI6MTIzfQ=="
  }
}

next_cursor が null の場合、次のページはありません。

エラーレスポンスは以下の形式で返されます。

{
  "code": "NOT_FOUND",
  "message": "Meeting not found"
}