OpenAPI 仕様
API の完全な機械可読マップ - すべてのエンドポイント、リクエスト、レスポンス、エラー。
OpenAPI は HTTP API を機械が読めるファイルで記述する業界標準の形式です。
https://api.wontopos.com/openapi.jsonこれで何ができるか
Postman: File → Import → URL を貼り付け - すべてのエンドポイントがクリック可能なコレクションになります。ChatGPT: GPT を作り、Action に同じ URL を貼り付け。コード生成: openapi-generator -i .../openapi.json -g go で未提供言語のクライアントも作れます。
Postman にインポート、未提供言語のクライアント生成、ChatGPT Actions の接続、CI での契約チェックに。テストが実際のルートに固定しているため、ずれることはありません。
llms.txt
AI が読めるテキスト 1 枚に収めた API の全体。
llms.txt はウェブの慣習です:サイトルートに置くプレーンテキスト 1 枚で、AI に製品について必要なすべてを伝えます。
https://wontopos.com/llms.txtIDE やコーディングエージェントに入れれば、WOS の上での作り方をすぐ理解します - 認証、エンドポイント、パターン、エラーまで。リリースごとに更新。
OpenAPI 仕様と同じ事実を、別の読者に:仕様はツール向けの精密な構造、このファイルは AI(や人)が一気に読める散文です。どちらもリリースごとに更新されます。