create-api.dev by Kong

create-api.dev é uma ferramenta de IA da Kong, a empresa por trás do Kong Gateway e do Insomnia. Ele se apresenta como o construtor de OpenAPI da Kong. Ela transforma a descrição escrita de uma API em uma especificação OpenAPI funcional, o arquivo padrão que mostra às ferramentas como seus endpoints, parâmetros e respostas se encaixam. Você não escreve o YAML à mão. Explica o que a API deveria fazer e o construtor monta a spec para você. Na prática, funciona como uma especificação de API gerada por IA que você pode editar, e não como um contrato fechado em que se confia de olhos fechados.

A ferramenta chega como um projeto do Kong Labs. Isso quer dizer que é uma prévia experimental, não um produto com suporte completo. A Kong pode mudá-la ou desativá-la a qualquer momento, e não existe promessa de disponibilidade nem canal de suporte formal. Ela também roda nos modelos de linguagem do Google, então seus prompts e os resultados passam por um provedor externo.

O limite principal é a precisão. Uma spec gerada por IA parece completa, mas pode trazer tipos de campo errados, casos de borda ausentes ou exemplos inventados. Trate o resultado como um bom primeiro rascunho que ainda precisa ser revisado linha a linha antes que alguém construa em cima dele.

Getting Started

1. Abra o create-api.dev no navegador e inicie uma sessão. Não há instalação nem formulário de cadastro antes.
2. Descreva a API em linguagem comum: o que ela faz, quais endpoints existem e o que cada um recebe e devolve.
3. Envie a descrição e deixe o construtor montar uma especificação OpenAPI a partir dela.
4. Revise o resultado. Confira rotas, métodos, parâmetros e formatos de resposta, e depois peça mudanças nas mensagens seguintes.
5. Exporte ou copie a spec final para o seu repositório e carregue no Insomnia, no Swagger UI ou no seu próprio pipeline.