Skip to content

인증

API 키

API 키는 요청 시 발급해 전달합니다. 소유한 브랜드의 데이터만 조회됩니다.

모든 요청에 키를 x-partner-api-key 헤더로 보냅니다.

bash
curl -H 'x-partner-api-key: YOUR_API_KEY' \
  'https://api.lemong.ai/partner/v1/brands'

키 관리 수칙

  • 키는 서버 환경변수나 시크릿 저장소에 보관해야 합니다.
  • 키가 노출됐다고 판단되면 즉시 담당자에게 재발급을 요청해 주세요. 재발급 즉시 이전 키는 무효화됩니다.
  • 키에는 만료일이 존재합니다. 만료 시 PARTNER_API_KEY_EXPIRED가 반환됩니다. 만료일에 대해서는 담당자에게 문의해 주세요.

인증 실패

HTTPcode의미
401PARTNER_API_KEY_REQUIRED헤더 누락
401PARTNER_API_KEY_INVALID등록되지 않은 키
401PARTNER_API_KEY_INACTIVE폐기된 키
401PARTNER_API_KEY_EXPIRED만료된 키
403PARTNER_API_FORBIDDEN권한 없는 리소스 (예: 다른 조직의 브랜드 코드)