API 레퍼런스

Authentication

CRM API의 Bearer 인증 형식과 키 범위를 설명하는 레퍼런스입니다.

Bearer 인증

/api/v1 관리 API는 다음 형식의 Bearer token을 받습니다.

plaintext

Authorization: Bearer <keyId>.<secret>

실제 값은 환경 변수에서 읽으세요.

bash

curl -sS https://crm.theseeker.io/api/v1/servers \
  -H "Authorization: Bearer $THESEEKER_API_KEY"

키	프로젝트 범위	서버 API
프로젝트 키	발급된 프로젝트로 고정	`servers:read`, `servers:write`
조직 키	조직 전체 프로젝트	`servers:read`, `servers:write`

admin:read는 읽기 endpoint를, admin:write는 변경 endpoint를 함께 승인합니다. 요청은 키에 부여된 scope 중 하나라도 endpoint 요구사항과 맞으면 승인됩니다.

인증 응답에는 현재 scope 기반 enforcement를 나타내는 X-Key-Enforcement: scopes 헤더가 포함될 수 있습니다.

토큰 누락, 형식 오류, 잘못된 secret, 폐기된 키는 401 UNAUTHORIZED입니다. 유효한 키지만 필요한 scope가 없으면 403 FORBIDDEN_SCOPE입니다. IP allowlist 밖의 요청은 403 ip_not_allowed입니다.

secret은 발급 직후 한 번만 표시됩니다. URL query string, 로그, 소스 코드에 넣지 마세요.

이 페이지가 도움이 되었나요?