Endpoints
GET /usage

GET /usage

Devuelve métricas de uso del tenant agregadas por día. Útil para dashboards de monitoreo y análisis de tendencias.

GET /api/v1/fe/usage?days=30
Authorization: Bearer <JWT>

Scope requerido: usage:read

Query params

ParamTipoDefaultMaxDescripción
daysnumber30180Cuántos días atrás incluir

Response — 200 OK

{
  "from": "2026-05-16",
  "to": "2026-06-15",
  "items": [
    {
      "date": "2026-05-16",
      "environment": "ecf",
      "requestsTotal": 1247,
      "requestsSuccess": 1198,
      "requestsError": 49,
      "emissionsSubmitted": 1247,
      "emissionsAccepted": 1180,
      "emissionsAcceptedConditional": 18,
      "emissionsRejected": 29,
      "emissionsPending": 20,
      "bytesIn": "62350000",
      "bytesOut": "8920000",
      "avgLatencyMs": 1850,
      "p95LatencyMs": 3200
    },
    {
      "date": "2026-05-16",
      "environment": "testecf",
      "requestsTotal": 45,
      /* ... */
    }
    /* ... más entries — una por (date, environment) ... */
  ]
}
CampoDescripción
dateYYYY-MM-DD del día
environment"ecf" | "testecf" | "certecf"
requestsTotalLlamadas HTTP totales del día
requestsSuccessHTTP 2xx
requestsErrorHTTP 4xx/5xx
emissionsSubmittedPOSTs a /invoices
emissionsAcceptedDGII estado='Aceptado'
emissionsAcceptedConditionalDGII estado='Aceptado Condicional'
emissionsRejectedDGII estado='Rechazado'
emissionsPendingAún no procesados al cierre del día
bytesInBytes recibidos (string para evitar overflow JS)
bytesOutBytes enviados
avgLatencyMsLatencia promedio (incluye DGII roundtrip)
p95LatencyMsPercentil 95

Notas

  • Los datos del día actual se agregan a la medianoche UTC siguiente. Para el contador real-time del día en curso, usa GET /billing/current-period.
  • bytesIn y bytesOut vienen como strings porque pueden exceder Number.MAX_SAFE_INTEGER en períodos largos. Convierte a BigInt o Decimal en tu cliente.
  • Sin datos para un (date, environment) → no aparece esa entry en items. No es un error.
InvoicesGET /billing