브랜드 목록

API 키를 할당받은 협력사의 브랜드 목록을 반환합니다. 여기서 받은 brand_code를 리뷰, 유저, 매장 조회 경로에 사용합니다.

GET /partner/v1/brands

Request

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

쿼리 파라미터

파라미터	타입	설명
page	number	기본 1
limit	number	기본 20, 최대 100

Response

{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "items": [
      {
        "brand_code": "BRAND100",
        "display_name": "몽도시락",
        "created_at": "2025-10-18T22:55:27+09:00"
      },
      {
        "brand_code": "BRAND101",
        "display_name": "몽샐러드",
        "created_at": "2025-10-19T23:00:00+09:00"
      }
    ],
    "page": 1,
    "limit": 20,
    "has_next": false
  }
}

Description

필드	타입	설명
brand_code	string	브랜드 식별자 - 다른 엔드포인트의 경로에 사용
display_name	string	브랜드 이름
created_at	string (KST)	브랜드 생성 시각

Error Case

에러 형식과 전체 코드는 에러 코드 를 참고하세요.

{
  "status": "PARTNER_API_KEY_EXPIRED",
  "status_code": 401,
  "message": "요청을 처리할 수 없습니다."
}

status_code	status	이 API 에서 발생하는 경우
401	PARTNER_API_KEY_REQUIRED	x-partner-api-key 헤더 누락
401	PARTNER_API_KEY_INVALID	등록되지 않은 키
401	PARTNER_API_KEY_INACTIVE	폐기된 키
401	PARTNER_API_KEY_EXPIRED	만료된 키
403	PARTNER_API_FORBIDDEN	비활성화된 협력사 (담당자 문의)
404	PARTNER_API_NOT_FOUND	잘못된 URL 경로
429	PARTNER_API_RATE_LIMITED	호출 제한 초과 (분당 100회)
500	PARTNER_API_INTERNAL_ERROR	서버 오류