Skip to main content
El microservicio procesa peticiones HTTP para renderizar documentos binarios (CSV o PDF) a partir de datos en formato JSON, utilizando un motor de estrategias dinámico.

​
🔌 Endpoint de Generación

​
/api/v1/reportes/generar
Compila un documento según los parámetros solicitados y devuelve el archivo binario (Blob) para su descarga.

​
🏷️ Cabeceras (Headers)

El motor detecta el idioma preferido del cliente para cambiarlo en el documento generado.

​
📦 Payload de la Petición (Body)

El endpoint espera un cuerpo en formato application/json validado por las reglas estrictas del controlador:
​
string
requerido
Define el motor de salida. Valores permitidos: csv, pdf.
​
string
Zona horaria del cliente para estampar la fecha de emisión (ej. America/Mexico_City). Si es nulo, se utiliza la zona horaria del servidor.
​
object
requerido
Contenedor principal del payload.

​
🚦 Reglas de Infraestructura

Para garantizar la estabilidad del servicio, el endpoint está protegido por un middleware perimetral:
  • Rate Limiting (Throttle): Se permite un máximo de 10 peticiones por minuto por dirección IP. Al superar este umbral, el servidor responderá con un error HTTP 429 Too Many Requests.