Saltar al contenido principal

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.

Requisitos

  • Python 3.9+
  • pandas y requests instalados:
    pip install pandas requests
    
  • Una consulta guardada en tu usuario de Tukan.

Obtener tus credenciales

Ejemplo: cargar una consulta a pandas

import pandas as pd
import requests

# TODO: Reemplazar con la URL real y el formato exacto del endpoint
QUERY_ID = "tu-query-id"
TOKEN = "tu-token-de-tukan"

url = f"https://api.tukanmx.com/queries/{QUERY_ID}/csv"  # TODO: confirmar URL
headers = {"Authorization": f"Bearer {TOKEN}"}  # TODO: confirmar esquema de auth

response = requests.get(url, headers=headers)
response.raise_for_status()

# TODO: Si el endpoint devuelve CSV directo
df = pd.read_csv(pd.io.common.StringIO(response.text))
print(df.head())

Ejemplo: respuesta JSON

import pandas as pd
import requests

# TODO: Confirmar si existe endpoint JSON paralelo
url = f"https://api.tukanmx.com/queries/{QUERY_ID}/json"
headers = {"Authorization": f"Bearer {TOKEN}"}

data = requests.get(url, headers=headers).json()
df = pd.DataFrame(data["rows"])  # TODO: confirmar estructura del payload

Buenas prácticas

  • Guarda el token como variable de entorno en lugar de hardcodearlo:
    import os
    TOKEN = os.environ["TUKAN_TOKEN"]
    
  • Cachea localmente si vas a reusar los mismos datos varias veces durante el día.
  • Maneja errores con response.raise_for_status() para detectar problemas de autenticación o rate limits.

Solución de problemas