Padrões do Módulo de API

InicianteGrátis2 minatualizado 2026-10-21

Gaveta de arquivo de metal aberta, com fichas de vidro iluminadas.

Este ficheiro complementa o CLAUDE.md da raiz para tudo o que está em /src/api/. Os ficheiros de memória são concatenados, não substituídos: o CLAUDE.md da raiz continua a aplicar-se, e o Claude Code carrega este ficheiro a pedido quando lê, escreve ou edita ficheiros nesta subárvore.

Padrões Específicos da API

Validação de Pedidos

Use o Zod para validação de esquemas
Valide sempre os dados de entrada
Devolva o código 400 com erros de validação
Inclua detalhes de erros ao nível de cada campo

Autenticação

Todos os endpoints exigem um token JWT
Token no cabeçalho Authorization
O token expira após 24 horas
Implemente um mecanismo de refresh token

Formato de Resposta

Todas as respostas devem seguir esta estrutura:

Terminal

{
  "success": true,
  "data": { /* actual data */ },
  "timestamp": "2025-11-06T10:30:00Z",
  "version": "1.0"
}

Respostas de erro:

Terminal

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "User message",
    "details": { /* field errors */ }
  },
  "timestamp": "2025-11-06T10:30:00Z"
}

Paginação

Use paginação baseada em cursores (não em deslocamento)
Inclua o booleano hasMore
Limite o tamanho máximo da página a 100
Tamanho de página predefinido: 20

Limitação de Pedidos

1000 pedidos por hora para utilizadores autenticados
100 pedidos por hora para endpoints públicos
Devolva 429 quando o limite for excedido
Inclua o cabeçalho retry-after

Cache

Use Redis para cache de sessões
Duração da cache: 5 minutos por predefinição
Invalide em operações de escrita
Marque as chaves da cache com o tipo de recurso

Última Atualização: 10 de outubro de 2026

Versão do Claude Code: 2.1.296

Fontes:

https://code.claude.com/docs/en/memory
https://github.com/anthropics/claude-code/releases/tag/v2.1.288
https://github.com/anthropics/claude-code/releases/tag/v2.1.293

Modelos Compatíveis: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5

Guia da comunidade open-source (MIT) · tradução e manutenção Doutor AI.

Precisa de uma solução à medida?

Não sabe por onde começar a usar IA no seu negócio? Receba uma avaliação gratuita e um plano à medida - sem compromisso.

Poupe horas todas as semanas com IA, sem complicações

O Doutor AI dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe.

Ver planos