Zettana API Docs

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 respuesta
  • message: mensaje descriptivo del endpoint
  • timestamp: 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.
Contactenos