// 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