Aller au contenu

Console et API

La console, l'API publique et Discovery : trois portes d'entrée sur Wakastart, ce que chacune permet et laquelle choisir pour une tâche.

ConceptAdministrateurDéveloppeurPartenaire
Voir en Markdown

Wakastart s'utilise par trois portes. La console sert aux personnes qui administrent. L'API publique sert à vos applications et à vos serveurs. Discovery sert à la connexion, avant toute authentification. Chaque tâche passe par une porte, parfois par deux.

Définition

Chargement du schéma…
PorteAdressePour quiAuthentification
Consolehttps://app.wakastart.appadministrateurs : partenaires, réseaux, clientsconnexion Keycloak, niveau Administrateur client au minimum
API publiquehttps://api.wakastart.app/apiwakapps et serveurs de vos clientsAuthorization: Bearer <jeton Keycloak>, x-enriched-token: <jeton enrichi> ou x-api-key: sk_… ; le jeton doit avoir été émis pour cette application
Discoveryhttps://discovery.wakastart.appwakapps, avant la connexionaucune

Pourquoi ça existe

Les besoins diffèrent. Un administrateur veut voir, comparer, confirmer : une interface. Une application veut des réponses rapides, au nom de l'utilisateur connecté et limitées à son organisation : une API. Et la connexion doit commencer avant que l'utilisateur ait le moindre jeton : un service public, Discovery.

Comment ça marche

Ce que fait chaque porte

TâcheConsoleAPI publiqueDiscovery
Trouver la page de connexion d'un utilisateur✔
Lire l'utilisateur connecté, son profil et ses droits✔ GET /api/me
Inviter des utilisateurs, gérer équipes et profils d'une organisation✔
Définir les droits, les profils et la matrice d'une application✔ Paramétrage✔
Décrire l'architecture, construire, déployer, exposer✔ uniquement
Gérer bases, buckets, variables, secrets, sauvegardes✔ uniquement
Lire le journal d'audit✔ Audit Logs✔ GET /api/audit-logs
Analyser un fichier, stocker des données de santé, encaisser un paiement✔
Lire les thèmes, langues et documents légaux de l'application✔

L'hébergement se pilote uniquement depuis la console : il n'existe pas d'API publique d'hébergement pour les clients.

Ce que l'API publique garantit

  • Le périmètre vient du jeton. L'organisation, l'application et l'environnement sont lus dans le jeton ou la clé, jamais dans la requête. Une clé API est bornée à son client, son réseau ou son application.
  • Une application, un jeton. Un jeton émis pour une autre application est refusé.
  • Des erreurs au même format :
JSON
{
  "statusCode": 403,
  "message": "Droit applicatif requis : invitations.create",
  "error": "Forbidden",
  "timestamp": "2026-10-23T09:30:00.000Z",
  "path": "/api/invitations"
}
  • Des limites de débit par adresse IP : 10 requêtes par seconde, 100 par minute, 1 000 par heure. Au-delà, l'API répond 429.

La documentation, aussi par API

Cette documentation se consulte depuis votre assistant IA, par le serveur MCP https://docs.wakastart.app/api/mcp, et chaque page existe en Markdown.

Exemples

Une clinique qui ajoute un soignant. Le cadre de santé l'invite depuis l'écran d'administration de votre application ; votre back appelle POST /api/invitations avec le jeton du cadre. La console n'intervient pas.

Une mise en production. Le développeur construit l'image et la déploie dans l'environnement de production depuis la console. Aucune API n'est appelée.

Une synchronisation nocturne. Le serveur RH d'un client lit chaque nuit la liste des utilisateurs avec une clé API sk_… limitée à son organisation.

Pour aller plus loin