Cómo autenticarte

El token se obtiene con tus credenciales (client_id y client_secret) y dura 2 horas. Después de ese tiempo expira y debes pedir uno nuevo.

Paso 1 — Obtener el token

Haz una solicitud POST con tus credenciales:

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

Si las credenciales son correctas, recibirás una respuesta como esta:

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

Paso 2 — Usar el token en tus solicitudes

Incluye el token en el header Authorization de cada solicitud:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Ejemplo completo

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

No necesitas enviar ningún identificador de empresa como parámetro. La API lo extrae automáticamente de tu token.

Paso 3 — Renovar el token cuando expire

El token dura 2 horas. Cuando expire verás un error 401. Simplemente repite el Paso 1 para obtener uno nuevo.

Problemas frecuentes

No tengo mis credenciales (client_id / client_secret)

Las credenciales las genera un administrador de Fracttal desde la sección Grupos de Permisos. Si no las tienes, contacta al administrador de tu cuenta.

El token no funciona — error 401

Hay varias razones por las que un token puede ser rechazado:

Ejemplo de respuesta cuando el token expiró:

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

Tengo token pero me da error 403

Esto significa que tu usuario tiene credenciales válidas pero no tiene permiso para usar el módulo ETL.

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

Solución: Un administrador de Fracttal debe habilitar el permiso Automatizador → Fracttal Hub en el Grupo de Permisos asociado a tus credenciales.

Resumen de errores de autenticación