API

API docs

正式な Swagger UI は OpenAPI 生成パイプライン確定後に公開します。現時点の主要 API は以下です。

認証

API は Firebase session、ID token、または PAT Bearer token で認証します。

curl -H "Authorization: Bearer $TSUTAWARU_TOKEN" \
  https://tsutawaru-feedback.com/api/v1/packs

主要 endpoint

GET/api/v1/auth/me現在の認証ユーザーを取得

GET/api/v1/packsAI向けフィードバック一覧

POST/api/v1/packsAI向けフィードバック作成

GET/api/v1/packs/:idAI向けフィードバック詳細

POST/api/v1/packs/:id/statusステータス更新

POST/api/v1/packs/:id/done完了マーク

POST/api/v1/packs/:id/supplements補足追加

GET/api/v1/packs/:id/video-url短時間有効な動画 URL を発行

POST/api/v1/recordings録画アップロード URL 作成

POST/api/v1/recordings/:id/browser-contextChrome 拡張 / Web 版 fallback のブラウザ文脈投稿

GET/api/v1/personal-access-tokensPAT 一覧

POST/api/v1/personal-access-tokensPAT 作成

エラー

400: request body、query、path parameter が不正
401: 未認証、token 不正、session 期限切れ
403: workspace 所属、role、scope が不足
404: 対象が存在しない、または閲覧権限がない
409: 状態遷移、二重処理、冪等性の競合
429: rate limit
500 / 502 / 503: サーバー、外部処理先、AI 処理の一時エラー

rate limit

signup、login、token、upload、billing、public URL には abuse 対策として rate limit を適用します。β 期間中は利用規模の上限も併用します。

example

curl -H "Authorization: Bearer $TSUTAWARU_TOKEN" \
  https://tsutawaru-feedback.com/api/v1/packs/demo-billing-save

curl -X POST \
  -H "Authorization: Bearer $TSUTAWARU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"comment":"修正完了"}' \
  https://tsutawaru-feedback.com/api/v1/packs/demo-billing-save/done