REST API
La API HTTP sobre la que se construyen el servidor MCP y la 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 de tu panel. Muestra la especificación OpenAPI con todos los endpoints, parámetros y esquemas 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 están bajo https://willet.bgenc.dev/api/v1. Los servidores auto-alojados sirven la misma API bajo <your-server>/api/v1.
La especificación OpenAPI 3.1 sin procesar está disponible 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 token bearer en cada petición: 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 ámbito 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 ha fallado. |
401 | Secreto no encontrado, inválido, revocado o caducado. |
403 | Al secreto le faltan permisos; por ejemplo, un secreto de solo lectura o limitado a un 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? La CLI envuelve todos estos endpoints con login, salida JSON y códigos de salida.
Referencia de la CLI →