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가 읽을 수 있는 텍스트 한 장에 담긴 API 전체.

llms.txt는 웹 관습입니다: 사이트 루트에 두는 순수 텍스트 한 장으로, AI에게 제품에 대해 필요한 전부를 알려줍니다.

https://wontopos.com/llms.txt

IDE나 코딩 에이전트에 넣으면 WOS 위에 어떻게 빌드하는지 바로 압니다 - 인증, 엔드포인트, 패턴, 에러까지. 릴리스마다 갱신됩니다.

OpenAPI 스펙과 같은 사실, 다른 청중입니다: 스펙은 도구를 위한 정밀한 구조이고, 이 파일은 AI나 사람이 한 번에 읽는 문서입니다. 둘 다 릴리스마다 함께 갱신됩니다.