Logs de integrações

O que você pode fazer?

Ver suas integrações — obtenha a lista de todas as integrações ETL configuradas para sua empresa.
Consultar o histórico de atividade — veja quantas vezes uma integração foi executada e quando.
Analisar resultados — veja o resumo de sucessos e falhas por fase em um intervalo de datas.
Explorar registros — busque e navegue pelos dados processados em uma execução específica.

Antes de começar

Você precisa de:

Um client_id e um client_secret — gerados por um administrador da Fracttal na seção Grupos de Permissão.
Que sua conta tenha o módulo Automatizador → Fracttal Hub habilitado.

Se estiver faltando algum desses, entre em contato com o administrador da sua conta antes de continuar.

Início rápido

1. Obtenha seu token de acesso

curl -X POST "https://one.fracttal.com/oauth/token" \
  -H "Authorization: Basic $(echo -n 'SEU_CLIENT_ID:SEU_CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

Guarde o valor de access_token — você vai precisar dele nos próximos passos. Ele dura 2 horas.

2. Liste suas integrações

curl -X GET "https://one.fracttal.com/hub/api/v1/dags" \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN"

Você receberá a lista das suas integrações com o respectivo dag_id. Use esse identificador nos próximos endpoints.

3. Consulte os registros de uma execução

curl -X GET "https://one.fracttal.com/hub/api/v1/dags/SEU_DAG_ID/runs/2026-06-05/SEU_RUN_ID/phases/load/data" \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN"

Conteúdo

Seção	Descrição
Como se autenticar	Como obter e usar seu token de acesso
Listar integrações ETL	Ver todas as suas integrações
Resumo de execuções	Estatísticas de sucessos e falhas por fase
Histórico de atividade	Atividade agrupada por dia, semana ou mês
Ver registros processados	Explorar os dados de uma execução específica

URL base

Todos os endpoints partem de:

https://one.fracttal.com/hub

# 1. Obter um token de acesso
TOKEN=$(curl -s -X POST https://one.fracttal.com/oauth/token \
  -H "Authorization: Basic $(echo -n 'CLIENT_ID:CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" | jq -r .access_token)

# 2. Listar os DAGs disponíveis
curl -s https://one.fracttal.com/hub/api/v1/dags \
  -H "Authorization: Bearer $TOKEN" | jq .

# 3. Inspecionar uma execução específica
DAG_ID="589b6c65-1ce9-4a46-9c11-ad380d9bf27a"
curl -s "https://one.fracttal.com/hub/api/v1/dags/$DAG_ID/runs/2026-06-05/manual_20260605T140709_c003" \
  -H "Authorization: Bearer $TOKEN" | jq .

# 4. Navegar pelas linhas da fase load
curl -s "https://one.fracttal.com/hub/api/v1/dags/$DAG_ID/runs/2026-06-05/manual_20260605T140709_c003/phases/load/data?page=0&limit=50" \
  -H "Authorization: Bearer $TOKEN" | jq