본문으로 이동

API 키 인증

콘솔 로그인과 서버 API 인증은 분리됩니다.

Bearer 인증

요청 헤더
Authorization: Bearer <platform-api-key>

업체와 실행 환경은 인증된 키에서 결정합니다. 요청 본문의 업체 ID로 권한을 바꾸지 않습니다.

발급과 보관

  • 고객 계정은 운영자가 등록합니다. 공개 회원가입은 지원하지 않습니다.
  • 개발·운영 키에 기능 권한, 게시 프로필, 만료 시간을 지정합니다.
  • 키 원문은 발급 직후 한 번만 표시합니다. 브라우저·공개 저장소·로그에 넣지 마세요.
  • 키를 교체하면 이전 키가 폐기됩니다. 폐기된 키는 복구할 수 없습니다.

최소 권한

profiles:read
허용 프로필 조회
jobs:write / jobs:read / jobs:cancel
작업 접수·조회·취소
assets:write / assets:read
원본 업로드·결과 다운로드
usage:read
키 범위의 사용량 조회

접근 범위

키에 허용된 프로필과 업체·환경 안의 작업·파일만 조회할 수 있습니다. 고객 세션이나 업체 API 키로 운영자 API에 접근할 수 없습니다.