Normas del módulo API

Este archivo complementa root CLAUDE.md para todo en /src/api/. Los archivos de memoria están concatenados, no anulados — el root CLAUDE.md todavía se aplica, y Claude Code carga este archivo bajo demanda cuando lee, escribe o edita archivos en este subárbol.

Normas específicas de la API

Solicitud de validación

Usar Zod para la validación de esquemas
Validar siempre la entrada
Devolver 400 con errores de validación
Incluir detalles de error a nivel de campo

Autenticación

Todos los puntos finales requieren token JWT
Token en la cabecera de autorización
Token expira después de 24 horas
Implementar un mecanismo de actualización token

Formato de respuesta

Todas las respuestas deben seguir esta estructura:

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

Respuestas de error:

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

Paginación

Usar la paginación basada en cursor (sin desplazamiento)
Incluir hasMore booleano
Limitar el tamaño máximo de la página a 100
Tamaño de página predeterminado: 20

Limitación de la tasa

1000 solicitudes por hora para usuarios autenticados
100 solicitudes por hora para puntos finales públicos
Retorno 429 cuando se supere
Incluir encabezado de reintento después

Caché

Usar Redis para almacenamiento en caché de sesión
Duración de la caché: 5 minutos por defecto
Invalidar en las operaciones de escritura
Claves de caché de etiquetas con tipo de recurso

Última actualización: 10 de octubre de 2026 Versión de Claude Code: 2.1.296 Fuentes: - 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 compatibles: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5