Autenticacion

Todas las peticiones a la API requieren autenticacion mediante API Key.

Obtener tu API Key

Crea una cuenta en ZUI GEN si aun no tienes una.
Ve al panel de API Keys en tu dashboard.
Haz clic en "Crear nueva API Key".
Guarda tu API Key de forma segura - solo se muestra una vez.

Formato de API Key

Las API Keys de ZUI GEN tienen el prefijo zui_ seguido de 32 caracteres alfanumericos:

zui_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Metodos de autenticacion

Puedes enviar tu API Key de dos formas:

1. Header Authorization (Recomendado)

Authorization Bearerbash

curl https://gen.zui.es/api/v1/me \
  -H "Authorization: Bearer zui_YOUR_API_KEY"

2. Header X-API-Key

X-API-Key headerbash

curl https://gen.zui.es/api/v1/me \
  -H "X-API-Key: zui_YOUR_API_KEY"

Ejemplos en codigo

JavaScript / TypeScriptjavascript

const response = await fetch('https://gen.zui.es/api/v1/me', {
  headers: {
    'Authorization': 'Bearer ' + process.env.ZUI_API_KEY,
  },
});
const data = await response.json();
console.log(data.credits.balance);

Pythonpython

import requests
import os
response = requests.get(
    'https://gen.zui.es/api/v1/me',
    headers={
        'Authorization': f'Bearer {os.environ["ZUI_API_KEY"]}'
    }
)
data = response.json()
print(data['credits']['balance'])

Seguridad

Nunca expongas tu API Key

No incluyas tu API Key en codigo del lado del cliente (JavaScript en navegador). Siempre usa variables de entorno o un backend seguro.

Usa variables de entorno para almacenar tu API Key.
Nunca subas tu API Key a repositorios publicos.
Rota tus API Keys periodicamente.
Si sospechas que tu key fue comprometida, revocala inmediatamente desde el panel.
Cada API Key tiene un registro de uso que puedes consultar.

Errores de autenticacion

Codigo	HTTP	Descripcion
`MISSING_API_KEY`	401	No se proporciono API Key
`INVALID_API_KEY_FORMAT`	401	La API Key no tiene el formato correcto (debe empezar con zui_)
`INVALID_API_KEY`	401	La API Key no existe o fue revocada
`SUBSCRIPTION_REQUIRED`	403	Se requiere una suscripcion activa para usar la API