인증

BIZ MORI API 요청을 인증하는 방법

모든 API 엔드포인트는 API 키를 Bearer 토큰 형식으로 전달하여 인증해야 합니다.

​

API 키 발급

1. BIZ MORI 개발자 센터에 로그인합니다
2. 설정 > API 키로 이동합니다
3. API 키 생성을 클릭합니다
4. 키를 복사하여 안전하게 보관합니다 — 한 번만 표시됩니다

API 키는 계정의 API에 대한 전체 접근 권한을 부여합니다. 클라이언트 코드, 공개 저장소, 버전 관리 시스템에 절대 노출하지 마세요. 환경 변수로 저장하세요.

​

API 키 사용 방법

모든 요청에서 Authorization: Bearer 헤더로 API 키를 전달합니다:

cURL

curl -X POST https://morimori.app/api/v2/orders/anti-ai \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey": "unique-key", "files": [{"fileName": "image.jpg"}]}'

​

요청 제한

플랜별 분당 요청 수 제한이 적용됩니다. 초과 시 429 Too Many Requests와 함께 RATE_LIMIT_EXCEEDED 오류 코드가 반환됩니다.

플랜	분당 요청 수
무료	60
Pro	300
Enterprise	1,000

높은 처리량이 필요한 경우 [e-mail]으로 문의하여 Enterprise 플랜의 요청 제한을 조정하세요.

​

멱등성 (Idempotency)

모든 주문 생성 엔드포인트는 idempotencyKey 파라미터를 지원합니다. 동일한 키로 중복 요청을 보내면 새 주문을 생성하는 대신 기존 주문을 반환합니다. 네트워크 재시도 시 이중 처리를 방지할 수 있습니다.

{
  "idempotencyKey": "unique-request-id-123",
  "files": [...]
}

UUID 또는 비즈니스 로직에서 파생된 결정론적 키(예: user-{id}-batch-{timestamp})를 사용하세요.