Lemong Partner API

Appearance

점주 목록 조회 ​

브랜드에 소속된 점주 목록과, 점주가 가진 플랫폼, 플랫폼의 연동 상태를 반환합니다. 여기서 받은 user_code 로 단건 조회를 하거나 매장, 매출 응답의 user 와 연결할 수 있습니다.

GET /partner/v1/brands/{brand_code}/users

Request ​

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

쿼리 파라미터 ​

파라미터타입설명
pagenumber기본 1
limitnumber기본 20, 최대 100

Response ​

json
{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "items": [
      {
        "user_code": "UK7M2QX4TVB",
        "display_name": "몽도시락 강남점",
        "platform_accounts": [
          { "platform": "BAEMIN", "status": "ACTIVE" },
          { "platform": "NAVER", "status": "ERROR" }
        ],
        "created_at": "2026-06-10T15:48:07+09:00"
      },
      {
        "user_code": "UP4RJ8NZQM2",
        "display_name": "몽도시락 역삼점",
        "platform_accounts": [{ "platform": "CPEATS", "status": "ACTIVE" }],
        "created_at": "2026-05-02T10:11:26+09:00"
      }
    ],
    "page": 1,
    "limit": 20,
    "has_next": false
  }
}

Description ​

필드타입설명
user_codestring유저 식별자 - 단건 조회 경로에 사용
display_namestring유저 표시명 (지점명)
platform_accountsobject[]유저가 연동한 플랫폼 계정
created_atstring (KST)브랜드에 등록된 시각

platform_accounts ​

필드타입설명
platformenum연동 플랫폼
statusenum연동 상태

platform_accounts.platform ​

값플랫폼
BAEMIN배달의민족
CPEATS쿠팡이츠
YOGIYO요기요
DDANGYO땡겨요
NAVER네이버 플레이스
MUKKEBI먹깨비

platform_accounts.status ​

값의미
ACTIVE정상 연동. 해당 플랫폼에 활성 매장이 있음
INACTIVE연동은 됐지만 활성 매장이 없음
ERROR플랫폼 로그인 실패 등 연동 오류. 수집이 멈춘 상태
LINKING연동 처리 중

댓글몽 플랫폼 설정 화면과 같은 기준입니다.

Error Case ​

json
{
  "status": "PARTNER_API_BRAND_NOT_FOUND",
  "status_code": 404,
  "message": "요청을 처리할 수 없습니다."
}
status_codestatus이 API 에서 발생하는 경우
401PARTNER_API_KEY_REQUIREDx-partner-api-key 헤더 누락
401PARTNER_API_KEY_INVALID등록되지 않은 키
401PARTNER_API_KEY_INACTIVE폐기된 키
401PARTNER_API_KEY_EXPIRED만료된 키
403PARTNER_API_FORBIDDEN비활성화된 협력사 (담당자 문의)
404PARTNER_API_BRAND_NOT_FOUNDbrand_code 가 없거나 이 키의 범위 밖
404PARTNER_API_NOT_FOUND잘못된 URL 경로
429PARTNER_API_RATE_LIMITED호출 제한 초과 (분당 100회)
500PARTNER_API_INTERNAL_ERROR서버 오류