Skip to main content

​
Autenticación

Para comenzar a utilizar la API de Tu Pana, necesitarás configurar la autenticación correctamente. Utilizamos un sistema de API Keys para garantizar la seguridad de tus transacciones.

​
Obtener tu API Key

  1. Ingresa a tu panel de control
  2. Ve a “Configuración > API”
  3. Haz clic en “Generar Nueva API Key”
  4. Guarda tu API Key en un lugar seguro - no podrás verla nuevamente

​
Usar tu API Key

​
Headers de Autenticación

Para autenticarte con la API, incluye tu API Key en el header de tus peticiones usando el prefijo Api-Key: 
curl -X POST https://api.tupana.ai/v1/documents \
  -H "Authorization: Api-Key TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "33", ...}'

​
Ejemplo en Python

import requests

api_key = "tu_api_key"
headers = {
    "Authorization": f"Api-Key {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.tupana.ai/v1/documents",
    headers=headers,
    json={"type": "33", ...}
)

​
Seguridad

​
Mejores Prácticas

  1. Nunca compartas tu API Key
  2. Rota tus API Keys regularmente
  3. Utiliza diferentes API Keys para producción y desarrollo
  4. Monitorea el uso de tus API Keys

​
Manejo de Errores

Si recibes un error de autenticación (401), verifica:
  1. Que estás usando la API Key correcta
  2. Que la API Key no ha expirado
  3. Que el formato del header es correcto (debe ser Authorization: Api-Key TU_API_KEY)
  4. Que la API Key está activa en tu panel de control

​
Siguientes Pasos

Una vez configurada la autenticación, puedes:
  1. Emitir tu primer documento
  2. Explorar los endpoints disponibles
  3. Configurar webhooks para notificaciones