인증
서버 전용 Bearer serving key입니다. 설정 토큰은 serving 엔드포인트를 호출할 수 없습니다.
Authorization: Bearer $KNOBASE_API_KEY
Content-Type: application/jsonKNOBASE_API_KEY
- 서버 전용입니다. 브라우저, 클라이언트 번들, LLM 프롬프트에 넣지 마세요.
- 폐기하거나 교체하기 전까지 장기 유효합니다.
- 하나의 앱과 환경에 묶입니다. 앱은 요청 body가 아니라 키에서 확인됩니다.
- kb_… 형식입니다. 원문을 커밋하거나 로그하지 마세요.
- 설정/부트스트랩 자격 증명(kb_setup_…)은 serving 엔드포인트를 호출할 수 없습니다.
- 워크스페이스 관리는 별도의 OAuth 토큰을 씁니다. serving 키는 /v1/workspaces 또는 /api/mcp를 호출할 수 없습니다.
인증 오류
| HTTP | error | 의미 |
|---|---|---|
| 401 | missing_authorization | Authorization 헤더 없음 |
| 401 | malformed_token | Bearer kb_…가 아니거나 설정 토큰 |
| 401 | invalid_token | 키 digest를 찾을 수 없음 |
| 401 | api_key_revoked | 키가 폐기되었거나 비활성 |