Skip to content

Acceso a la API

WallaWhats expone las mismas operaciones que usa el panel a través de una API HTTP JSON. Úsala para programar la gestión de suscripciones, traer el historial de notificaciones a tus propios sistemas o integrar alertas con herramientas internas. Cada plan de pago incluye acceso a la API — consulta Gestiona tu plan para los límites de claves por plan.

Paso 1 — Abre Claves API

En la barra lateral, haz clic en Claves API (en Claves de acceso).

Página de Claves API con una clave por defecto

Paso 2 — Crea una clave

  1. Haz clic en Crear clave.
  2. Dale un nombre (ej. servidor-produccion, dev-local). El nombre es sólo una etiqueta — no afecta a los permisos.
  3. Haz clic en Crear.

El valor completo de la clave se muestra una vez — cópialo inmediatamente en tu gestor de secretos. WallaWhats sólo almacena un hash más un prefijo corto (bws_xxxxxxxx…), por lo que no se puede recuperar después.

Trata las claves como contraseñas

Cualquiera con la clave puede actuar en tu cuenta. Guarda las claves en un gestor de secretos, nunca las subas a git y rótalas periódicamente.

Paso 3 — Usa la clave

Envía la clave en la cabecera x-api-key en cada solicitud:

bash
curl -H "x-api-key: bws_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://api.wallawhats.com/subscriptions

Los endpoints disponibles, los cuerpos de solicitud y las formas de respuesta están documentados en la Referencia de API.

Paso 4 — Rotar o revocar

  • Rotar — crea una clave nueva, despliégala y después elimina la vieja. No hay un botón de "rotar" por diseño; crear-luego-eliminar hace el cambio atómico.
  • Revocar — haz clic en Eliminar junto a la fila de la clave. La clave deja de funcionar al instante. Cualquier solicitud en curso que la use devolverá 401 Unauthorized.

Límites del plan

PlanClaves API
Free1
Pro1
Pro+2
Business5
Enterprise20

Si alcanzas el límite, Crear clave se deshabilita — elimina una clave vieja primero o mejora tu plan.

Qué sigue

Para los esquemas de solicitud/respuesta y la lista completa de endpoints, ver la Referencia de API →

WallaWhats Documentation