Skip to content

점주 단건 조회

점주 단건 데이터를 반환합니다. 목록 조회로 받은 user_code를 사용합니다.

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

Request

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

Response

json
{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "user_code": "UK7M2QX4TVB",
    "display_name": "몽도시락 강남점",
    "platform_accounts": [
      { "platform": "BAEMIN", "status": "ACTIVE" },
      { "platform": "NAVER", "status": "ERROR" }
    ],
    "created_at": "2026-06-10T15:48:07+09:00"
  }
}

TIP

data는 배열이 아니라 유저 객체입니다.

Description

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

Error Case

json
{
  "status": "PARTNER_API_USER_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_USER_NOT_FOUNDuser_code 가 없거나 이 브랜드 소속이 아님
404PARTNER_API_NOT_FOUND잘못된 URL 경로
429PARTNER_API_RATE_LIMITED호출 제한 초과 (분당 100회)
500PARTNER_API_INTERNAL_ERROR서버 오류