Códigos de error
Todos los errores devuelven { status: "error", code, message, details? }. El límite de 60 peticiones por minuto por IP se detalla en /docs/rate-limits.
400INVALID_PARAMS
Falta un parámetro obligatorio o tiene un valor no válido (p. ej. "count").
Solución recomendada:Revisa los parámetros contra la referencia del endpoint y sus valores permitidos.
400INVALID_BODY
El cuerpo de la petición no es JSON válido, o no tiene la forma esperada.
Solución recomendada:Envía `Content-Type: application/json` con un body que cumpla el esquema del endpoint.
404UNKNOWN_GENERATOR
El `generator` de la URL no existe (`GET /generators` lista los válidos).
Solución recomendada:Consulta `GET /api/v1/generators` o la lista de generadores en /docs/generadores.
400UNSUPPORTED_LOCALE
El `locale` de la URL no está soportado (por ahora solo "es").
Solución recomendada:Usa "es" como locale hasta que se añadan más países.
413COUNT_LIMIT_EXCEEDED
"count" supera el máximo permitido por ese endpoint.
Solución recomendada:Reduce `count` al límite indicado en la referencia del endpoint, o pagina varias peticiones.
429RATE_LIMIT_EXCEEDED
Se superó el límite de peticiones por minuto para tu IP.
Solución recomendada:Espera al `X-RateLimit-Reset` indicado en la cabecera de respuesta, o agrupa varias filas en una sola petición con `count`.