Como se autenticar

Passo 1 — Obter o token

Faça uma solicitação POST com suas credenciais:

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"

Se as credenciais estiverem corretas, você receberá uma resposta como esta:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 7200
}

Campo	Descrição
`access_token`	O token que você usará em todas as solicitações
`token_type`	Sempre será `Bearer`
`expires_in`	Tempo de vida em segundos (`7200` = 2 horas)

Passo 2 — Usar o token nas suas solicitações

Inclua o token no cabeçalho Authorization de cada solicitação:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Exemplo completo

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

Você não precisa enviar nenhum identificador de empresa como parâmetro. A API o extrai automaticamente do seu token.

Passo 3 — Renovar o token quando expirar

O token dura 2 horas. Quando expirar, você verá um erro 401. Basta repetir o Passo 1 para obter um novo.

Problemas frequentes

Não tenho minhas credenciais (`client_id` / `client_secret`)

As credenciais são geradas por um administrador da Fracttal na seção Grupos de Permissão. Se você não as tiver, entre em contato com o administrador da sua conta.

O token não funciona — erro `401`

Há várias razões pelas quais um token pode ser rejeitado:

Situação	O que fazer
Você esqueceu de incluir o cabeçalho `Authorization`	Adicione `Authorization: Bearer <token>` à solicitação
Você escreveu o cabeçalho errado (ex.: `Authorisation` ou sem `Bearer`)	Verifique se está exatamente `Authorization: Bearer <token>`
O token expirou (passaram mais de 2 horas)	Solicite um novo repetindo o Passo 1
As credenciais estão incorretas	Verifique seu `client_id` e `client_secret` com o administrador

Exemplo de resposta quando o token expirou:

{
  "error_code": "TOKEN_EXPIRED",
  "message": "The provided token has expired",
  "status_code": 401
}

Tenho token, mas recebo erro `403`

Isso significa que seu usuário tem credenciais válidas, mas não tem permissão para usar o módulo ETL.

{
  "error_code": "OAUTH2_ETL_ACCESS_DENIED",
  "message": "This OAuth2 client does not have access to the ETL module",
  "status_code": 403
}

Solução: Um administrador da Fracttal deve habilitar a permissão Automatizador → Fracttal Hub no Grupo de Permissão associado às suas credenciais.

Resumo dos erros de autenticação

Código	Causa	Solução
`401`	Cabeçalho `Authorization` ausente ou mal escrito	Revisar o formato do cabeçalho
`401`	Token expirado	Solicitar um novo token
`401`	`client_id` ou `client_secret` incorretos	Verificar as credenciais com o administrador
`403`	Sem permissão para o módulo ETL	Solicitar ao administrador que a habilite