Códigos de Respuestas

Formato de Respuesta

Todas las respuestas del API están en formato JSON y siguen una estructura consistente:

{
  "data": { ... },
  "errors": [ ... ]
}

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Descripción del error"
  }
}

El API utiliza códigos de estado HTTP estándar:

Código	Descripción
`200`	Solicitud exitosa
`201`	Recurso creado exitosamente
`400`	Solicitud incorrecta (parámetros inválidos)
`401`	No autenticado
`403`	No autorizado
`404`	Recurso no encontrado
`405`	Método HTTP no permitido
`500`	Error interno del servidor

Código	Descripción
`MISSING_API_KEY`	El header `X-API-Key` es requerido
`INVALID_API_KEY`	API Key inválido, inactivo o no coincide con el ambiente (sandbox/production)
`API_KEY_ENVIRONMENT_MISMATCH`	El API Key no coincide con el ambiente solicitado en el header `X-Sandbox-Mode`
`UNAUTHORIZED`	El header `Authorization` es requerido o tiene formato inválido
`INVALID_TOKEN`	Token JWT inválido o no contiene los claims requeridos
`TOKEN_EXPIRED`	El token JWT ha expirado

Código	Descripción
`INVALID_INPUT`	Los datos proporcionados no cumplen con las reglas de validación. Ver mensaje para detalles
`MISSING_REQUIRED_FIELD`	Falta un campo requerido. Ver mensaje para detalles
`SANDBOX_NOT_SUPPORTED`	Este endpoint no soporta modo sandbox
`RESOURCE_ALREADY_EXISTS`	El recurso que se intenta crear ya existe. Ver mensaje para detalles

Código	Descripción
`ROUTE_NOT_FOUND`	La ruta solicitada no existe
`METHOD_NOT_ALLOWED`	El método HTTP no está permitido para este endpoint

Código	Descripción
`INTERNAL_ERROR`	Error interno del servidor
`AUTH_ERROR`	Error en el proceso de autenticación
`API_KEY_CREATION_FAILED`	Fallo al crear el API Key
`ASSOCIATION_FAILED`	Fallo al asociar API Key con Usage Plan
`CREATION_FAILED`	Fallo al crear API Key