Accés API

WallaWhats exposa les mateixes operacions que utilitza el tauler a través d'una API HTTP JSON. Fes-la servir per scriptar la gestió de subscripcions, portar l'historial de notificacions als teus propis sistemes o integrar alertes amb eines internes. Cada pla de pagament inclou accés API — consulta Gestiona el pla per als límits de claus per pla.

Pas 1 — Obre Claus API

A la barra lateral, fes clic a Claus API (sota Claus d'accés).

Pas 2 — Crea una clau

1. Fes clic a Crear clau.
2. Dona a la clau un nom (ex. servidor-produccio, dev-local). El nom només és una etiqueta — no afecta els permisos.
3. Fes clic a Crear.

El valor complet de la clau es mostra una vegada — copia-la immediatament al teu gestor de secrets. WallaWhats només emmagatzema un hash més un prefix curt (bws_xxxxxxxx…), de manera que no es pot recuperar després.

Tracta les claus com a contrasenyes

Qualsevol amb la clau pot actuar al teu compte. Guarda les claus en un gestor de secrets, no les facis commit mai a git, i fes-les rotar periòdicament.

Pas 3 — Usa la clau

Envia la clau a la capçalera x-api-key a cada petició:

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

Els endpoints disponibles, els cossos de petició i les formes de resposta estan documentats a la Referència API.

Pas 4 — Rotació o revocació

• Rotació — crea una clau nova, desplega-la i després elimina la vella. No hi ha botó "rotar" per disseny; crear-i-eliminar fa el canvi atòmic.
• Revocar — fes clic a Eliminar al costat de la fila de la clau. La clau deixa de funcionar instantàniament. Qualsevol petició en curs que la faci servir retornarà 401 Unauthorized.

Límits del pla

Pla	Claus API
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Si arribes al límit, Crear clau queda deshabilitat — elimina primer una clau vella o millora el pla.

Què segueix

Per als esquemes de petició/resposta i la llista completa d'endpoints, vegeu la Referència API →.