본문으로
Knobase

인증

서버 전용 Bearer serving key입니다. 설정 토큰은 serving 엔드포인트를 호출할 수 없습니다.

Authorization: Bearer $KNOBASE_API_KEY
Content-Type: application/json

KNOBASE_API_KEY

  • 서버 전용입니다. 브라우저, 클라이언트 번들, LLM 프롬프트에 넣지 마세요.
  • 폐기하거나 교체하기 전까지 장기 유효합니다.
  • 하나의 앱과 환경에 묶입니다. 앱은 요청 body가 아니라 키에서 확인됩니다.
  • kb_… 형식입니다. 원문을 커밋하거나 로그하지 마세요.
  • 설정/부트스트랩 자격 증명(kb_setup_…)은 serving 엔드포인트를 호출할 수 없습니다.
  • 워크스페이스 관리는 별도의 OAuth 토큰을 씁니다. serving 키는 /v1/workspaces 또는 /api/mcp를 호출할 수 없습니다.

인증 오류

HTTPerror의미
401missing_authorizationAuthorization 헤더 없음
401malformed_tokenBearer kb_…가 아니거나 설정 토큰
401invalid_token키 digest를 찾을 수 없음
401api_key_revoked키가 폐기되었거나 비활성

문서 버전 v1 · 구현된 퍼블리셔 API 기준