REST API と webhook Early Adopter

プラン

REST API と webhook は Early Adopter プラン以上でご利用いただけます。プランと請求をご覧ください。

会議をスタックの他の部分に取り込みましょう。REST API で構造化されたメモと文字起こしを取得し、メモの準備が整った瞬間に webhook を受け取って、Slack、CRM、データウェアハウスへ自動的にプッシュできます。

認証

1. Web アプリで 設定 → 開発者 を開きます。
2. チーム用の API トークン を作成します。
3. 各リクエストでベアラートークンとして送信します。

curl https://platform.scribx.app/api/v1/recordings \
  -H "Authorization: Bearer YOUR_API_TOKEN"

トークンはチームにスコープされており、いつでも取り消せます。

取得できるもの

• 録画 — メタデータ付きで会議を一覧表示・取得
• 文字起こし — 話者ラベルとタイムスタンプ付きの全行
• 要約 — 構造化されたまとめとアクションアイテム

常に最新の完全なスキーマは、アプリ内の API リファレンス（Swagger UI）でご覧いただけます。設定 → 開発者 からリンクされています。

Webhook

webhook の URL を登録すると、ScribX は主要なイベント発生時にそこへ POST します。最も便利なのは、会議の メモの準備が整った ときです。

1. 設定 → 開発者 で、webhook エンドポイントを追加します。
2. 購読するイベントを選びます。
3. お客様のエンドポイントは、録画 ID とイベントタイプを含む JSON ペイロードを受け取ります。詳細は API 経由で取得してください。

{
  "event": "recording.note_ready",
  "recording_id": "rec_…",
  "team_id": "proj_…"
}

ヒント

ペイロードを検証して 2xx を素早く返し、その後重い処理を非同期で行いましょう。ScribX は 2xx 以外のレスポンスの場合に再試行します。

次のステップ

• MCP サーバー
• 連携