Accès API

WallaWhats expose les mêmes opérations que le tableau de bord à travers une API HTTP JSON. Utilisez-la pour scripter la gestion des abonnements, récupérer l'historique des notifications dans vos propres systèmes ou intégrer les alertes avec votre outillage interne. Chaque plan payant inclut l'accès API — voir Gérez votre plan pour les limites de clés par plan.

Étape 1 — Ouvrez Clés API

Dans la barre latérale, cliquez sur Clés API (sous Clés d'accès).

Étape 2 — Créer une clé

1. Cliquez sur Créer une clé.
2. Donnez à la clé un nom (ex. serveur-prod, dev-local). Le nom n'est qu'une étiquette — il n'affecte pas les permissions.
3. Cliquez sur Créer.

La valeur complète de la clé s'affiche une seule fois — copiez-la immédiatement dans votre gestionnaire de secrets. WallaWhats ne conserve qu'un hash plus un préfixe court (bws_xxxxxxxx…), elle ne peut donc plus être récupérée par la suite.

Traitez les clés comme des mots de passe

Toute personne disposant de la clé peut agir sur votre compte. Stockez les clés dans un gestionnaire de secrets, ne les commitez jamais dans git, et faites-les tourner régulièrement.

Étape 3 — Utiliser la clé

Envoyez la clé dans l'en-tête x-api-key à chaque requête :

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

Les endpoints disponibles, les corps de requête et les formes de réponse sont documentés dans la Référence API.

Étape 4 — Faire tourner ou révoquer

• Rotation — créez une clé fraîche, déployez-la, puis supprimez l'ancienne. Pas de bouton « rotation » par design ; créer-puis-supprimer rend la bascule atomique.
• Révoquer — cliquez sur Supprimer à côté de la ligne de la clé. La clé cesse de fonctionner instantanément. Toute requête en cours l'utilisant renvoie 401 Unauthorized.

Limites du plan

Plan	Clés API
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Si vous atteignez la limite, Créer une clé est désactivé — supprimez d'abord une ancienne clé ou passez à un plan supérieur.

Et ensuite

Pour les schémas requête/réponse et la liste complète des endpoints, voir la Référence API →