REST API

Die HTTP-API, auf der der MCP-Server und die CLI aufbauen. Nutze sie, um Willet mit allem zu integrieren, das HTTP spricht.

Interaktive Referenz

Die vollständige, stets aktuelle Endpoint-Referenz ist der interaktive API-Explorer in deinem Dashboard. Er rendert die OpenAPI-Spezifikation mit allen Endpoints, Parametern und Response-Schemas und ermöglicht es dir, Live-Anfragen gegen dein Konto mit einem kurzlebigen Token auszuführen.

API-Explorer öffnen

Basis-URL

Bei Willet Cloud liegt jeder Endpunkt unter https://willet.bgenc.dev/api/v1. Self-gehostete Server stellen dieselbe API bereit unter <your-server>/api/v1.

Die rohe OpenAPI 3.1-Spezifikation wird bereitgestellt unter /api/v1/openapi.json falls du lieber einen Client generieren oder ihn in deine eigenen Tools importieren möchtest.

Authentifizierung

Sende bei jeder Anfrage ein API-Geheimnis als Bearer-Token: Authorization: Bearer <secret>.

curl -H "Authorization: Bearer $WILLET_API_TOKEN" \
  https://willet.bgenc.dev/api/v1/me

Erstelle auf Willet Cloud im Dashboard unter Einstellungen → API-Geheimnisse ein Geheimnis. Jedes Geheimnis hat einen Geltungsbereich und eine Zugriffsebene:

user / project wählt alle deine Projekte oder nur eines aus.
read / read_write wählt nur Lesezugriff oder vollen Lese-/Schreibzugriff aus.

Fehler

Fehler geben einen Nicht-2xx-Status und einen JSON-Body zurück: { "error": "message", "details": [...] }.

`400`	Anforderungsvalidierung fehlgeschlagen.
`401`	Fehlendes, ungültiges, widerrufenes oder abgelaufenes Secret.
`403`	Dem Secret fehlen die erforderlichen Berechtigungen, z. B. ein schreibgeschütztes oder projektbezogenes Secret, das dort verwendet wird, wo es nicht erlaubt ist.
`404`	Die Ressource existiert nicht.
`501`	Ein Cloud-only-Endpunkt, der auf einem selbst gehosteten Server aufgerufen wird.

Weiter

Lieber die Kommandozeile? Die CLI bietet all diese Endpunkte mit Login, JSON-Ausgabe und Exit-Codes.

CLI-Referenz →