Skip to main content
모든 API 엔드포인트는 Authorization: Bearer 헤더의 API 키가 필요합니다. BIZ MORI 대시보드에서 키를 발급해 안전하게 보관하세요. 키는 한 번만 표시됩니다.

API 키 발급

  1. BIZ MORI 대시보드에 로그인합니다.
  2. API Keys로 이동합니다.
  3. Issue New Key를 선택합니다.
  4. 키를 복사해 안전하게 보관합니다. 키는 한 번만 표시됩니다.
API 키는 계정 접근 권한을 부여합니다. 브라우저 코드, 저장소, 버전 관리에 노출하지 마세요.

API 키 사용

새 논리 주문마다 UUIDv4를 생성합니다. 아래 예제는 첫 Anti-AI 주문 전에 키를 생성합니다.

멱등성

새 논리 주문마다 새 UUIDv4를 사용합니다. Anti-AI와 AI Detection의 confirm은 별도 논리 요청이므로 각각 다른 UUIDv4를 생성합니다. 네트워크 실패 후 같은 논리 요청을 재시도할 때만 이전 값을 재사용하세요. 같은 키를 다시 보내면 새 주문 대신 기존 주문이 반환됩니다.

Rate limit

모든 요청에는 15분당 1,000회의 전역 제한이 적용되며 표준 RateLimit 헤더가 포함됩니다. 일부 엔드포인트에는 별도의 endpoint-specific 제한이 추가로 적용될 수 있습니다. live 주문 API 키의 플랜 사용량 quota는 전역 요청 제한과 별개입니다. 이 quota가 소진되고 활성 credit pack이 없으면 주문 API는 HTTP 429와 { "code": "PLAN_LIMIT_EXCEEDED" }를 반환합니다. 테스트 API 키는 플랜 사용량 quota를 우회하지만 API 키 인증보다 먼저 실행되는 전역 요청 limiter는 우회하지 않습니다.

Live 및 테스트 API 키

live 키의 uploadUrl은 S3 presigned URL입니다. 테스트 키의 URL은 https://api.bizmori.com/api/v2/test-uploads/{signedToken} 형식의 절대 BIZ MORI API URL입니다. 두 URL 모두 발급 후 1시간 동안 유효합니다. 업로드와 재발급은 빠른 시작, 테스트 키 웹훅 범위는 웹훅에서 확인하세요.