구매자
구매자 목록 조회
GET
accessTokenheader
AuthorizationBearer <token>Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)
q?string검색어 — 이름·이메일(포함). 숫자 4자리면 휴대폰 뒤 4자리로도 찾는다
joinedFrom?string가입일 시작(YYYY-MM-DD, KST, 포함)
joinedTo?string가입일 끝(YYYY-MM-DD, KST, 포함)
marketing?string마케팅 수신 동의 필터. 생략하면 전체
Value in
"agreed""declined"sort?string정렬. joined_desc(기본, 최근 가입순)·joined_asc·total_paid_desc(구매 금액순)·order_count_desc(주문 수순)·last_ordered_desc(최근 주문순)
Value in
"joined_desc""joined_asc""total_paid_desc""order_count_desc""last_ordered_desc"page?string페이지 번호 (1부터, 기본 1)
size?string페이지 크기 (기본 20, 최대 100)
X-Store-Id*string대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다
성공
application/json- response
meta*data*error*|nullcurl -X GET 'https://api.sayren.io/v1/customers' \ -H 'X-Store-Id: string'{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "page": 0, "size": 0, "totalElements": 0, "totalPages": 0, "contents": [ { "customerId": "string", "name": "string", "email": "string", "maskedPhone": "string", "joinedAt": "string", "point": 0, "marketingAgreed": true, "orderCount": 0, "totalPaid": 0, "lastOrderedAt": "string" } ] }, "error": null}