get
https://one.fracttal.com/hub/api/v1/dags/{dag_id}/stats/
Com este endpoint você pode obter um resumo das execuções de um DAG dentro de um intervalo de datas específico, mostrando quantas tiveram sucesso, falharam ou não foram executadas em cada fase.
Autenticação
Requer um Bearer token OAuth2 obtido pelo fluxo client_credentials. Ver Autenticação.
Parâmetros de rota
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
dag_id | string (UUID) | ✅ | UUID do DAG no formato 8-4-4-4-12 |
Parâmetros de consulta
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
start_date | string (YYYY-MM-DD) | ✅ | Início do intervalo de datas (inclusive) |
end_date | string (YYYY-MM-DD) | ✅ | Fim do intervalo de datas (inclusive) |
Cabeçalhos
| Nome | Valor |
|---|---|
Authorization | Bearer <access_token> |
Accept | application/json |
Exemplo 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/jsonResposta bem-sucedida — 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 | Descrição |
|---|---|---|
total_runs | integer | Total de execuções no intervalo |
fully_successful | integer | Execuções em que as 3 fases foram bem-sucedidas |
any_phase_failed | integer | Execuções em que ao menos uma fase falhou |
extract | object | Distribuição success / failed / not_run da fase |
transform | object | Distribuição success / failed / not_run da fase |
load | object | Distribuição success / failed / not_run da fase |
date_range | object | Intervalo de datas aplicado (from / to) |
Códigos de erro
| Código | Descrição |
|---|---|
401 | Token inválido ou expirado |
422 | Intervalo de datas inválido — verificar details[] |
502 | Erro ao consultar as estatísticas |
Possíveis problemas
Todos os erros seguem o formato RFC 9457 com Content-Type: application/problem+json.
401 — Token ausente, inválido ou expirado
401 — Token ausente, inválido ou expiradoVer Problemas de autenticação.
422 — Intervalo de datas inválido
422 — Intervalo de datas 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 frequentes: datas em formato incorreto, ou start_date posterior a end_date.
502 — Erro em serviço dependente
502 — Erro em serviço dependente{
"error_code": "BACKEND_RPC_ERROR",
"message": "Upstream service returned an unexpected error",
"status_code": 502
}Solução: Repita a tentativa com backoff exponencial.
OpenAPI definition
{
"openapi": "3.0.0",
"info": {
"version": "1.0.0",
"title": "Estatística de execução de um DAG"
},
"servers": [
{
"url": "https://one.fracttal.com/hub/api/v1/dags/{dag_id}/stats"
}
],
"paths": {
"/": {
"get": {
"responses": {
"200": {
"description": ""
}
},
"parameters": [],
"description": "Com este endpoint você pode obter um resumo das execuções de um DAG dentro de um intervalo de datas específico, mostrando quantas tiveram sucesso, falharam ou não foram executadas em cada fase.",
"summary": "Listar resumo de execuções",
"operationId": "get_"
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}