인증
API Key 발급 및 인증 방법
인증
QA Note API는 API Key 기반 인증을 사용합니다. 모든 API 요청에는 유효한 API Key가 필요합니다.
Base URL
https://qanote.app
API Key 발급
- QA Note 대시보드에 로그인합니다
- 좌측 사이드바에서 조직 설정으로 이동합니다
- API Keys 탭을 클릭합니다
- 새 API Key 생성 버튼을 클릭합니다
- 이름과 권한(Scopes)을 설정한 후 생성합니다
- 생성된 키를 안전한 곳에 저장합니다 (다시 확인할 수 없습니다)
인증 헤더
모든 API 요청의 Authorization 헤더에 Bearer 토큰 형식으로 API Key를 포함합니다.
bash
curl https://qanote.app/api/v1/projects \
-H "Authorization: Bearer qn_YOUR_API_KEY"
Scopes
API Key 생성 시 필요한 권한을 선택할 수 있습니다. Scope를 지정하지 않으면 모든 권한이 부여됩니다.
| Scope | 설명 |
|---|---|
issues:read | 이슈, 코멘트, 로그, 스크린샷 조회 |
issues:write | 이슈 상태/우선순위 변경, 코멘트 작성 |
projects:read | 프로젝트 목록 조회 |
Rate Limiting
API 요청은 분당 60회로 제한됩니다. 제한을 초과하면 429 Too Many Requests 응답이 반환됩니다.
제한은 API Key/OAuth 토큰별로 적용되며, 인증값을 바꿔가며 우회하는 공격을 막기 위한 IP별 보조 제한도 함께 적용됩니다.
/api/v1 요청 본문은 최대 64KB, /api/mcp 요청 본문은 최대 256KB입니다. 초과 시 413 Payload Too Large가 반환됩니다.