読み込み中
豆知識
このページの本体は、Scalar で描画した OpenAPI 3.2 の API ブラウザです。エンドポイント・スキーマ・例を一覧して、認証なしの公開エンドポイントはそのまま試せます。
code 一覧Authorization: Bearer <token>)/api/health, /api/public/demo/*)OpenAPI 仕様の単一の真実は、バックエンドリポジトリ solo-boss-cloud_backend の src/docs/swagger.ts です。バックエンド側で npm run export:openapi を実行するとスナップショットが書き出され、フロントエンド側で npm run sync:openapi でこのドキュメントサイトに取り込まれます。/docs/api-reference はそのスナップショットを Scalar React で描画します。
閲覧だけなら、/docs/api-reference の公開コピーで足ります。バックエンドを起動していなくても見られます。
Scalar の "Try it" から実際に認証付き API を叩く場合は、通常のアプリと同じ Bearer JWT が必要です。認証なしの公開エンドポイント (/api/health, /api/public/demo/*) はそのまま確認できます。
読み込み中
豆知識