create-api.dev by Kong

create-api.dev는 Kong Gateway와 Insomnia를 만든 Kong의 AI 도구다. 글로 쓴 API 설명을 실제로 쓸 수 있는 OpenAPI 명세로 바꾼다. OpenAPI는 엔드포인트와 매개변수, 응답이 어떻게 맞물리는지 여러 도구에 알려 주는 표준 파일 형식이다. YAML을 손으로 쓰지 않아도 된다. API가 무엇을 해야 하는지 설명하면 빌더가 명세를 대신 작성한다. 실제로는 그대로 믿는 확정 계약이 아니라 손볼 수 있는 AI가 생성한 API 명세로 쓰는 물건이다.

이 도구는 Kong Labs 프로젝트로 제공된다. 완전한 지원 제품이 아니라 실험적 미리보기라는 뜻이다. Kong은 언제든 바꾸거나 중단할 수 있고, 가용성 약속도 공식 지원 창구도 없다. 게다가 Google의 언어 모델 위에서 돌아가므로 입력한 프롬프트와 결과가 외부 제공자를 거친다.

가장 큰 한계는 정확성이다. AI가 초안한 명세는 완성돼 보여도 잘못된 필드 타입, 빠진 경계 조건, 지어낸 예시가 섞일 수 있다. 누군가 이를 토대로 만들기 전에 줄 단위로 검토해야 할 초안으로 다루는 게 낫다.

Getting Started

1. 브라우저에서 create-api.dev를 열고 세션을 시작한다. 설치도, 미리 채울 가입 양식도 없다.
2. API를 평범한 말로 설명한다. 무엇을 하는지, 어떤 엔드포인트가 있는지, 각각 무엇을 받고 무엇을 돌려주는지 적는다.
3. 설명을 보내고, 그로부터 OpenAPI 명세를 초안하게 한다.
4. 결과를 확인한다. 경로, 메서드, 매개변수, 응답 형태를 점검하고 이어지는 메시지로 수정을 요청한다.
5. 완성된 명세를 내보내거나 저장소에 복사한 뒤 Insomnia, Swagger UI, 자체 파이프라인에 불러온다.