> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tukanmx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación

> Cómo autenticar tus solicitudes a la API de Tukan Atlas.

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

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://client.tukanmx.com/tukan-atlas/indicators/?page_size=5" \
    -H "Authorization: Token $API_TUKAN"
  ```

  ```python Python theme={null}
  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"])
  ```
</CodeGroup>

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

```json theme={null}
{"detail": "Invalid token header. No credentials provided."}
```

<Note>
  Todas las rutas de Atlas terminan en diagonal.

  Si la omites, la solicitud falla, así que usa siempre la ruta con diagonal final.
</Note>

## 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](mailto: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](mailto:contacto@tukanmx.com) contándonos brevemente tu caso de uso y te ayudaremos a comenzar.