REST API

MCP 서버와 CLI의 기반이 되는 HTTP API입니다. HTTP를 사용하는 모든 것과 Willet을 연동할 수 있습니다.

인터랙티브 레퍼런스

완전하고 항상 최신 상태인 엔드포인트 레퍼런스는 대시보드의 인터랙티브 API 탐색기입니다. OpenAPI 스펙을 모든 엔드포인트, 파라미터, 응답 스키마와 함께 렌더링하며, 단기 토큰을 사용해 계정에 실제 요청을 직접 실행해볼 수 있습니다.

Willet Cloud에서 모든 엔드포인트는 다음 아래에 있습니다 https://willet.bgenc.dev/api/v1. 셀프 호스팅 서버는 다음 아래에서 동일한 API를 제공합니다 <your-server>/api/v1.

원시 OpenAPI 3.1 스펙은 다음에서 제공됩니다 /api/v1/openapi.json 클라이언트를 직접 생성하거나 자체 툴링에 가져오려는 경우에 사용하세요.

모든 요청에 API 시크릿을 bearer 토큰으로 전송하세요: Authorization: Bearer <secret>.

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

Willet Cloud에서는 대시보드의 설정 → API 시크릿 메뉴에서 시크릿을 발급하세요. 각 시크릿에는 범위와 접근 수준이 있습니다:

오류는 2xx가 아닌 상태 코드와 JSON 본문을 반환합니다: { "error": "message", "details": [...] }.

`400`	요청 유효성 검사에 실패했습니다.
`401`	시크릿이 없거나, 유효하지 않거나, 취소되었거나, 만료되었습니다.
`403`	시크릿에 권한이 없습니다. 예를 들어, 읽기 전용 또는 프로젝트 범위의 시크릿을 허용되지 않는 곳에 사용한 경우입니다.
`404`	리소스가 존재하지 않습니다.
`501`	셀프 호스팅 서버에서 호출된 Cloud 전용 엔드포인트입니다.

터미널이 더 편하신가요? CLI를 사용하면 로그인, JSON 출력, 종료 코드와 함께 이 모든 엔드포인트를 바로 쓸 수 있어요.