커스텀몰 API / 회원 조회

커스텀몰 API  /  회원 조회

회원 조회

회원을 연결하면 담당자가 상담 중에 회원 등급과 가입일을 바로 볼 수 있어요. 선택 기능이에요 (capabilities members).

회원 ID로 조회

GET/v1/customers/{member_id}

응답은 { "data": Customer }예요. 회원이 없으면 404를 돌려주세요.

요청
curl "https://api.mall.example.com/v1/customers/m_1001" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01"
응답 — 200 OK
{
  "data": {
    "member_id": "m_1001",
    "name": "K*** S.",
    "cellphone": "010-****-5821",
    "email": "ki***@example.com",
    "group_no": "2",
    "group_name": "VIP",
    "created_date": "2025-06-02T00:00:00+09:00"
  }
}

전화번호로 찾기

GET/v1/customers?cellphone={cellphone}

응답은 { "data": [Customer] }예요. 릴로는 결과가 정확히 1명일 때만 고객과 연결해요.

Customer 필드

member_idstring필수

회원 ID

namestring선택

이름 (마스킹)

cellphonestring선택

휴대폰 (마스킹, 예: 010-****-5821)

emailstring선택

이메일 (마스킹, 예: ki***@example.com)

group_nostring선택

회원 등급 번호

group_namestring선택

확장. 회원 등급 이름

created_datestring선택

가입 시각

개인정보

cellphone·email은 마스킹한 값만 보내 주세요. 카페24 원본은 평문이지만 릴로에는 마스킹해서 주세요.

회원 조회 · 개발자 문서 | 릴로