REST API
La API HTTP sobre la que están construidos el servidor MCP y el CLI. Úsala para integrar Willet con cualquier cosa que hable HTTP.
Referencia interactiva
La referencia completa y siempre actualizada de endpoints es el explorador de API interactivo en tu panel. Muestra la especificación OpenAPI con cada endpoint, parámetro y esquema de respuesta, y te permite ejecutar solicitudes en vivo contra tu cuenta usando un token de corta duración.
URL base
En Willet Cloud, todos los endpoints viven bajo https://willet.bgenc.dev/api/v1. Los servidores autohospedados sirven la misma API bajo <your-server>/api/v1.
El spec de OpenAPI 3.1 sin procesar se sirve en /api/v1/openapi.json si prefieres generar un cliente o importarlo en tus propias herramientas.
Autenticación
Envía un secreto de API como bearer token en cada solicitud: Authorization: Bearer <secret>.
curl -H "Authorization: Bearer $WILLET_API_TOKEN" \
https://willet.bgenc.dev/api/v1/meEn Willet Cloud, genera un secreto en el panel en Configuración → Secretos de API. Cada secreto tiene un alcance y un nivel de acceso:
user/projectelige todos tus proyectos, o solo uno.read/read_writeelige solo lectura, o lectura/escritura completa.
Errores
Los errores devuelven un estado no 2xx y un cuerpo JSON: { "error": "message", "details": [...] }.
400 | La validación de la solicitud falló. |
401 | Secreto faltante, inválido, revocado o vencido. |
403 | Al secreto le faltan permisos, p. ej., un secreto de solo lectura o con alcance de proyecto usado donde no está permitido. |
404 | El recurso no existe. |
501 | Un endpoint exclusivo de Cloud llamado en un servidor autoalojado. |
Siguiente
¿Prefieres la terminal? El CLI envuelve todos estos endpoints con login, salida JSON y códigos de salida.
Referencia del CLI →