REST API
L'API HTTP sur laquelle reposent le serveur MCP et la CLI. Utilisez-la pour intégrer Willet avec n'importe quel système qui parle HTTP.
Référence interactive
La référence complète et toujours à jour, c'est l'explorateur d'API interactif dans votre tableau de bord. Il affiche la spec OpenAPI avec tous les endpoints, paramètres et schémas de réponse, et vous permet d'envoyer des requêtes en direct sur votre compte à l'aide d'un token de courte durée.
URL de base
Sur Willet Cloud, chaque endpoint se trouve sous https://willet.bgenc.dev/api/v1. Les serveurs auto-hébergés servent la même API sous <your-server>/api/v1.
La spécification OpenAPI 3.1 brute est disponible à /api/v1/openapi.json si vous préférez générer un client ou l'importer dans vos propres outils.
Authentification
Envoyez un secret API comme token bearer à chaque requête : Authorization: Bearer <secret>.
curl -H "Authorization: Bearer $WILLET_API_TOKEN" \
https://willet.bgenc.dev/api/v1/meSur Willet Cloud, créez un secret depuis le tableau de bord sous Paramètres → Secrets API. Chaque secret a une portée et un niveau d'accès :
user/projectchoisit tous vos projets, ou un seul.read/read_writechoisit lecture seule, ou lecture/écriture complète.
Erreurs
Les erreurs retournent un statut non-2xx et un corps JSON : { "error": "message", "details": [...] }.
400 | La validation de la requête a échoué. |
401 | Secret manquant, invalide, révoqué ou expiré. |
403 | Le secret n'a pas les permissions requises, par exemple un secret en lecture seule ou limité à un projet utilisé dans un contexte non autorisé. |
404 | La ressource n'existe pas. |
501 | Un endpoint Cloud uniquement appelé sur un serveur auto-hébergé. |
Suivant
Vous préférez le terminal ? Le CLI expose tous ces endpoints avec authentification, sortie JSON et codes de retour.
Référence CLI →