get
https://one.fracttal.com/hub/api/v1/dags/{dag_id}/timeline/
Com este endpoint você pode visualizar a atividade de execuções de um DAG agrupada por intervalos de tempo: hora, dia, semana ou mês. Útil para identificar padrões de carga e detectar períodos com maior quantidade de falhas.
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/ETL no formato 8-4-4-4-12 |
Parâmetros de consulta
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
start_date | string (YYYY-MM-DD) | ✅ | — | Início do intervalo de datas |
end_date | string (YYYY-MM-DD) | ✅ | — | Fim do intervalo de datas |
interval | string | — | day | Agrupamento: hour, day, week ou month |
Cabeçalhos
| Nome | Valor |
|---|---|
Authorization | Bearer <access_token> |
Accept | application/json |
Exemplo de request
GET /hub/api/v1/dags/589b6c65-1ce9-4a46-9c11-ad380d9bf27a/timeline?start_date=2026-06-01&end_date=2026-06-05&interval=day
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Accept: application/jsonResposta bem-sucedida — 200
{
"interval": "day",
"points": [
{ "timestamp": "2026-06-03", "total_runs": 5, "successful": 5, "failed": 0 },
{ "timestamp": "2026-06-04", "total_runs": 8, "successful": 7, "failed": 1 },
{ "timestamp": "2026-06-05", "total_runs": 6, "successful": 6, "failed": 0 }
]
}| Campo | Tipo | Descrição |
|---|---|---|
interval | string | Intervalo de agrupamento aplicado |
points | array | Pontos da linha do tempo |
points[].timestamp | string | Início do bucket (formato conforme interval) |
points[].total_runs | integer | Total de execuções no bucket |
points[].successful | integer | Execuções totalmente bem-sucedidas |
points[].failed | integer | Execuções com pelo menos uma fase com falha |
Códigos de erro
| Código | Descrição |
|---|---|
401 | Token inválido ou expirado |
422 | Intervalo de datas ou interval inválido — verificar details[] |
502 | Erro ao consultar a linha do tempo |
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 — Parâmetro inválido
422 — Parâmetro inválido{
"error_code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"status_code": 422,
"details": [
{ "field": "interval", "message": "interval must be one of: hour, day, week, month" }
]
}Causas frequentes: datas em formato incorreto, start_date posterior a end_date, ou valor de interval fora do enum.
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": "Linha do tempo de execuções de um DAG"
},
"servers": [
{
"url": " https://one.fracttal.com/hub/api/v1/dags/{dag_id}/timeline"
}
],
"paths": {
"/": {
"get": {
"responses": {
"200": {
"description": ""
}
},
"parameters": [],
"summary": "Listar histórico de atividade de fluxos de integrações",
"operationId": "get_",
"description": "Com este endpoint você pode visualizar a atividade de execuções de um DAG agrupada por intervalos de tempo: hora, dia, semana ou mês. Útil para identificar padrões de carga e detectar períodos com maior quantidade de falhas."
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}