Autenticación - Documentación Tukan

Todas las solicitudes a Atlas se autentican con un token personal que viaja en el header Authorization, con el prefijo Token (la palabra Token, un espacio y tu token).

Authorization: Token tu-token

Ejemplo

curl "https://client.tukanmx.com/tukan-atlas/indicators/?page_size=5" \
  -H "Authorization: Token $API_TUKAN"

import os
import requests

headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}

resp = requests.get(
    "https://client.tukanmx.com/tukan-atlas/indicators/",
    headers=headers,
    params={"page_size": 5},
)
resp.raise_for_status()
print(resp.json()["count"])

Si el token falta o es inválido, la API responde 401:

{"detail": "Invalid token header. No credentials provided."}

Todas las rutas de Atlas terminan en diagonal.Si la omites, la solicitud falla, así que usa siempre la ruta con diagonal final.

Buenas prácticas

Nunca escribas el token directamente en tu código. Guárdalo como una variable de entorno (en los ejemplos de esta documentación usamos API_TUKAN) o en tu secrets manager.
No lo compartas ni lo subas a repositorios. El token identifica a tu cuenta, así que todo lo que se consulte con él cuenta como uso tuyo.
Si crees que tu token se filtró, escríbenos a contacto@tukanmx.com para rotarlo.

¿Cómo obtengo un token?

Mientras Atlas esté en Beta cerrada, el acceso se otorga manualmente. Escríbenos a contacto@tukanmx.com contándonos brevemente tu caso de uso y te ayudaremos a comenzar.