pitfalls-express-api
Construa APIs Express com padrões REST adequados
O desenvolvimento de APIs Express frequentemente leva a rotas inconsistentes, códigos de status incorretos e lógica de armazenamento fortemente acoplada. Esta skill fornece padrões comprovados para rotas RESTful, códigos de status HTTP, interfaces de armazenamento e gerenciamento de tarefas em segundo plano.
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "pitfalls-express-api". Crie uma API de usuários com operações CRUD
Résultat attendu:
- GET /api/users - Retorna lista de usuários (200)
- GET /api/users/:id - Retorna um único usuário (200) ou não encontrado (404)
- POST /api/admin/users - Cria usuário (201) com validação
- PATCH /api/admin/users/:id - Atualiza usuário (200) ou não encontrado (404)
- DELETE /api/admin/users/:id - Exclui usuário (204)
Utilisation de "pitfalls-express-api". Como devo lidar com códigos de status para um endpoint PATCH?
Résultat attendu:
- 200 OK em atualização bem-sucedida com dados modificados
- 404 Not Found quando o recurso não existe
- 400 Bad Request quando a validação falha
- 204 No Content não é recomendado para PATCH, pois a resposta normalmente inclui dados atualizados
Utilisation de "pitfalls-express-api". Crie uma interface de armazenamento para produtos
Résultat attendu:
- interface IStorage com métodos getProducts, getProduct, createProduct, updateProduct, deleteProduct
- Classe DbStorage implementando backend PostgreSQL
- Classe MemStorage implementando armazenamento em memória para testes
- Operações CRUD genéricas usando tipos TypeScript
Audit de sécurité
SûrThis is a pure documentation skill containing only TypeScript code examples in markdown. The static scanner triggered on markdown code block backticks and function naming conventions that have no security implications. All 41 findings are false positives caused by the scanner misinterpreting documentation syntax as code patterns.
Facteurs de risque
🌐 Accès réseau (1)
📁 Accès au système de fichiers (1)
⚙️ Commandes externes (5)
Score de qualité
Ce que vous pouvez construire
Construir APIs consistentes
Aplicar convenções REST e padrões de código de status ao criar novas rotas e endpoints Express.
Revisar implementações de API
Verificar se APIs Express existentes seguem as melhores práticas para estrutura de rotas e tratamento de erros.
Projetar interfaces de armazenamento
Criar camadas de armazenamento abstraídas que suportam diferentes backends e facilitam testes.
Essayez ces prompts
Crie uma nova rota Express para [resource] seguindo convenções REST. Inclua validação, códigos de status apropriados e tratamento de erros.
Revise estas rotas Express quanto à conformidade REST, códigos de status corretos e validação ausente. Aponte quaisquer anti-padrões.
Projete uma interface de armazenamento TypeScript para [entity] com operações de criar, ler, atualizar e excluir. Inclua uma implementação em memória para testes.
Adicione uma tarefa em segundo plano ao meu aplicativo Express que execute a cada 5 minutos. Inclua limpeza adequada ao sair do processo e proteção contra sobreposição.
Bonnes pratiques
- Separe rotas públicas e de administrador com middleware de autenticação apropriado
- Sempre valide corpos de requisição antes do processamento com middleware
- Defina interfaces de armazenamento para abstrair detalhes de implementação do banco de dados
- Limpe intervalos de tarefas em segundo plano nos sinais de encerramento do processo
Éviter
- Usar códigos de status HTTP inconsistentes em operações similares
- Pular validação de entrada em endpoints de criação e atualização
- Implementar lógica de armazenamento diretamente em manipuladores de rota
- Executar tarefas em segundo plano sobrepostas sem proteção