get
https://one.fracttal.com/hub/api/v1/dags/{dag_id}/stats/
Con este endpoint puedes obtener un resumen de cuántas ejecuciones de un DAG tuvieron éxito, fallaron o no se ejecutaron por fase, dentro de un rango de fechas. ###
Autenticación
Requiere un Bearer token OAuth2 obtenido mediante el flujo client_credentials. Ver Autenticación.
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
dag_id | string (UUID) | ✅ | UUID del DAG/ETL en formato 8-4-4-4-12 |
Query parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
start_date | string (YYYY-MM-DD) | ✅ | Inicio del rango de fechas (inclusive) |
end_date | string (YYYY-MM-DD) | ✅ | Fin del rango de fechas (inclusive) |
Encabezados
| Nombre | Valor |
|---|---|
Authorization | Bearer <access_token> |
Accept | application/json |
Ejemplo de request
GET /hub/api/v1/dags/589b6c65-1ce9-4a46-9c11-ad380d9bf27a/stats?start_date=2026-06-01&end_date=2026-06-05
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Accept: application/jsonRespuesta exitosa — 200
{
"total_runs": 42,
"fully_successful": 38,
"any_phase_failed": 4,
"extract": { "success": 42, "failed": 0, "not_run": 0 },
"transform": { "success": 40, "failed": 2, "not_run": 0 },
"load": { "success": 38, "failed": 4, "not_run": 0 },
"date_range": { "from": "2026-06-01", "to": "2026-06-05" }
}| Campo | Tipo | Descripción |
|---|---|---|
total_runs | integer | Total de ejecuciones en el rango |
fully_successful | integer | Ejecuciones donde las 3 fases fueron exitosas |
any_phase_failed | integer | Ejecuciones donde al menos una fase falló |
extract | object | Distribución success / failed / not_run de la fase |
transform | object | Distribución success / failed / not_run de la fase |
load | object | Distribución success / failed / not_run de la fase |
date_range | object | Rango de fechas aplicado (from / to) |
Códigos de error
| Código | Descripción |
|---|---|
401 | Token inválido o expirado |
422 | Rango de fechas inválido — revisar details[] |
502 | Error al consultar estadísticas |
Problemas posibles
Todos los errores siguen el formato RFC 9457 con Content-Type: application/problem+json.
401 — Token ausente, inválido o expirado
401 — Token ausente, inválido o expiradoVer Problemas de autenticación.
422 — Rango de fechas inválido
422 — Rango de fechas inválido{
"error_code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"status_code": 422,
"details": [
{ "field": "start_date", "message": "start_date must be in YYYY-MM-DD format" }
]
}Causas frecuentes: fechas en formato incorrecto o start_date posterior a end_date.
502 — Error en servicio dependiente
502 — Error en servicio dependiente{
"error_code": "BACKEND_RPC_ERROR",
"message": "Upstream service returned an unexpected error",
"status_code": 502
}Solución: Reintenta con backoff exponencial.