// api guide / authentication
인증
모든 호출은 Authorization: Bearer h6s_live_... 헤더 하나로 인증한다. 워크스페이스는 API 키에서 자동 해석되어 별도 파라미터로 보내지 않는다.
1. API 키 발급
콘솔에서 발급한다. 라이브 키는 한 번만 평문 노출되니 발급 직후 자기 시스템의 secret 매니저(.env · k8s secret · AWS Secrets Manager 등) 에 저장한다.
콘솔에서 API 키 발급2. 헤더 형식
Authorization 헤더
# 모든 호출에 Bearer 헤더 1줄
curl -sS https://api.h6s.ai/api/v1/data-jobs \
-H "Authorization: Bearer $H6S_API_KEY"3. Rate Limit
분당 100, 시간당 5000 (per API Key). 초과하면 HTTP 429 와 {"code":"API_RATE_LIMITED",...} 응답. 모든 응답에 잔여 한도 헤더가 포함된다.
응답 헤더 — rate limit
# 응답 헤더에서 잔여 한도 확인
X-RateLimit-Limit-Minute: 100
X-RateLimit-Limit-Hour: 5000
X-RateLimit-Remaining: 87
# 초과 시 (HTTP 429)
Retry-After: 12