Dicas de ferramentas para api design para API Design

Prompt gerado automaticamente para Ferramentas para API Design em API Design

5.0
35 usos
ChatGPT
Usar no ChatGPT
"Você é um especialista em API Design. Crie um prompt detalhado para uma ferramenta de geração automática de documentação OpenAPI (Swagger/AsyncAPI). O prompt deve solicitar a geração de um trecho de documentação para um novo endpoint REST que:

1. **Permite** a criação de um novo recurso "Produto" (método POST).
2. **Requer** autenticação via Bearer Token (OAuth 2.0 ou JWT).
3. **Espera** um corpo de requisição JSON com os campos `nome` (string, obrigatório), `descricao` (string, opcional) e `preco` (número, obrigatório, formato float).
4. **Retorna** um status `201 Created` em caso de sucesso, com o corpo da resposta contendo o ID do produto criado e a data de criação.
5. **Retorna** um status `400 Bad Request` se a validação dos dados de entrada falhar, com uma mensagem de erro descritiva.
6. **Retorna** um status `401 Unauthorized` se a autenticação falhar.
7. **Inclui** exemplos de requisição e resposta para os cenários de sucesso e falha (400 e 401).
8. **Sugere** tags relevantes para o endpoint (e.g., "Produtos", "Catálogo").

A documentação gerada deve ser clara, concisa e seguir as melhores práticas do OpenAPI Specification, incluindo descrições para cada campo, exemplos e referências a componentes de esquema se aplicável. O objetivo é que essa documentação possa ser diretamente integrada em um arquivo `openapi.yaml` ou `openapi.json`."

Como Usar este Prompt

1

Clique no botão "Copiar Prompt" para copiar o conteúdo completo.

2

Abra sua ferramenta de IA de preferência (ChatGPT e etc.).

3

Cole o prompt e substitua as variáveis (se houver) com suas informações.

Compartilhe

Gostou deste prompt? Ajude outras pessoas a encontrá-lo!

Outros prompts de API Design

Continue explorando prompts nesta categoria.

Guia para troubleshooting em api design em API Design

Prompt gerado automaticamente para Troubleshooting em API Design em API Design

Guia para testing em api design em API Design

Prompt gerado automaticamente para Testing em API Design em API Design

Guia para testing em api design em API Design

Prompt gerado automaticamente para Testing em API Design em API Design