인증과 권한

REST API는 워크스페이스 API 키를 Bearer 헤더로 받습니다. 키 원문은 만들 때 한 번만 표시되므로 안전한 비밀 보관함에 보관해 주세요.

curl -H 'Authorization: Bearer <API_KEY>' \
  -H 'X-Workspace-Id: <WORKSPACE_ID>' \
  'https://<서비스-도메인>/api/v1/platforms'

워크스페이스와 권한

키가 여러 워크스페이스에 속하면 X-Workspace-Id가 필요합니다. 작업마다 accounts:read, posts:write 같은 권한 범위를 검사합니다. 필요한 권한은 API 동작 목록에서 확인하세요.

401은 키·로그인 상태를, 403은 인증 완료 여부와 권한 범위를 확인해 주세요. 요청마다 X-Request-Id를 기록하면 오류를 추적할 수 있습니다.

{
  "error": {
    "code": "unauthenticated",
    "message": "로그인 또는 인증 정보가 없습니다. 로그인하거나 유효한 키를 넣어 주세요."
  }
}