API Connector Platform — Overview
TAS-CHA は外部システム連携のための公開 API を /v1/... で提供する。 本ドキュメントは Public API・Webhook・コネクタ・Remote MCP を含む API Connector Platform の全体像と、 ユーザー / 開発者がどのドキュメントから読み始めればいいかを示 す。
Quickstart — 最初の /v1 リクエスト
1. API key を発行する
Authentication — API key と OAuth、 actor、 scope
/v1/... は 2 系統の認証を受け付ける。 JWT (内部 frontend 用) は受け付けない。
Rate Limits — 500 円 / user モデルと API units
設計の基本方針
Public API — /v1 リファレンス
正式仕様は OpenAPI 3.1 (apps/backend/openapi/public-api.yaml)。 本ドキュメントは概念ガイド。
Webhooks — イベント、 署名、 リプレイ防止
Webhook は api_version で webhook 単位に契約を出し分ける。 既存 (v1) は v1 形式 body + X-Webhook-*、 新規は v2 契約で配信される。
OpenClaw Connector
設定 UI は /settings/developer の「Connectors (OpenClaw)」セクション。
Remote MCP
Remote MCP は読み取り専用です。 write tools は提供していません。
Connector Runtime
Connector Runtime は外部連携（OpenClaw など）の共通基盤。 認可・credential 管理・rate limit・監査を一元化する。
Security
OWASP API Security Top 10 2023 を acceptance criteria に含める。