Accesso API

WallaWhats espone le stesse operazioni che la dashboard usa attraverso un'API HTTP JSON. Usala per automatizzare la gestione delle iscrizioni, recuperare la cronologia delle notifiche nei tuoi sistemi o integrare avvisi con strumenti interni. Ogni piano a pagamento include l'accesso API — vedi Gestisci il piano per i limiti di chiavi per piano.

Passo 1 — Apri Chiavi API

Nella barra laterale, clicca su Chiavi API (sotto Chiavi di accesso).

Passo 2 — Creare una chiave

1. Clicca su Crea chiave.
2. Dai alla chiave un nome (es. server-prod, dev-locale). Il nome è solo un'etichetta — non influenza i permessi.
3. Clicca su Crea.

Il valore completo della chiave viene mostrato una sola volta — copialo subito nel tuo gestore di segreti. WallaWhats memorizza solo un hash più un breve prefisso (bws_xxxxxxxx…), quindi non può essere recuperato dopo.

Tratta le chiavi come password

Chiunque abbia la chiave può agire sul tuo account. Memorizza le chiavi in un gestore di segreti, non committarle mai in git, e ruotale periodicamente.

Passo 3 — Usa la chiave

Invia la chiave nell'header x-api-key ad ogni richiesta:

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

Endpoint disponibili, corpi di richiesta e formati di risposta sono documentati nel Riferimento API.

Passo 4 — Ruotare o revocare

• Ruotare — crea una chiave nuova, distribuiscila, poi elimina quella vecchia. Non c'è un pulsante "ruota" per design; crea-poi-elimina rende il passaggio atomico.
• Revocare — clicca su Elimina accanto alla riga della chiave. La chiave smette di funzionare istantaneamente. Qualsiasi richiesta in corso che la usa restituisce 401 Unauthorized.

Limiti del piano

Piano	Chiavi API
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Se raggiungi il limite, Crea chiave è disabilitato — elimina prima una chiave vecchia o aggiorna il piano.

Cosa segue

Per gli schemi di richiesta/risposta e l'elenco completo degli endpoint, vedi il Riferimento API →