API v1
Autenticación
Aprende a autenticarte usando una API key.
Cómo autenticarte
Para consumir la API de Zettana necesitas una API key válida. Envíala en el
header x-api-key en cada request.
Header requerido
Incluye x-api-key en cada request que hagas a la API de Zettana.
Ejemplo
import requests
BASE_URL = "https://backend.zettana.com/v1"
API_KEY = "REEMPLAZA_CON_TU_API_KEY"
response = requests.get(
f"{BASE_URL}/api-health",
headers={"x-api-key": API_KEY},
timeout=30,
)
response.raise_for_status()
print(response.json())Campos de salida
El endpoint /v1/api-health responde con un objeto JSON con estos campos:
status: estado general de la respuestamessage: mensaje descriptivo del endpointtimestamp: fecha y hora de la respuesta en formato ISO 8601
Ejemplo de salida
{
"status": "ok",
"message": "Welcome to Zettana API!",
"timestamp": "2026-04-11T12:34:56.000Z"
}Cuándo se rechaza
La autenticación por API key será rechazada si:
- la API key es incorrecta
- la API key fue revocada
- tu plan ya no tiene acceso a la API habilitado
Recomendaciones
- Guarda tu API key en variables de entorno o en un gestor de secretos.
- Asegúrate de mantener tu API key privada y no compartirla con terceros no autorizados.
- Si crees que una API key fue expuesta, revócala y crea una nueva desde Zettana.