Skip to main content
멤버가 가입했는지 또는 탈퇴했는지, 접근 수준, 그리고 계정의 콘텐츠를 마지막으로 연 시점을 추적합니다. Members API를 사용하여 계정의 멤버를 조회 및 검색하고, 단일 멤버를 조회하고, 멤버의 활동 로그를 읽을 수 있습니다. 멤버 행은 멤버십 수명 주기에 의해 생성 및 유지되므로, 접근 권한을 부여하거나 취소하려면 대신 멤버십을 사용하세요.
Legacy Members 리소스를 대체합니다. 기존 Legacy 통합은 계속 작동합니다. 안정성 보장에 대해서는 API 버전을 참조하세요.

엔드포인트

속성

string
필수
멤버 ID이며, 접두사는 mber_입니다.
string
필수
멤버가 계정에서 접근할 수 있는 범위입니다: 결제 멤버는 customer, 팀원은 admin, 모든 권한이 만료되면 no_access입니다.사용 가능한 옵션: no_access, admin, customer
string
필수
이 멤버가 속한 계정으로, 접두사는 biz_입니다.
string
필수
멤버 레코드가 생성된 시점으로, ISO 8601 타임스탬프입니다.
string
필수
이 멤버에 대해 표시할 이름입니다: 사용자의 이름, 또는 이름을 설정하지 않은 경우 사용자 이름입니다. user가 null인 경우 구매한 비즈니스의 이름입니다.
object | null
필수
Whop 전체에서 사용자의 총수입(USD)으로, 주기적으로 갱신됩니다. 사용자가 수입을 숨기거나 구매자가 다른 비즈니스인 경우 null입니다.

속성

string
필수
최근 24시간 동안의 총수입(USD)입니다.
string
필수
최근 30일 동안의 총수입(USD)입니다.
string
필수
최근 7일 동안의 총수입(USD)입니다.
string
필수
전체 기간 총수입(USD)입니다.
string | null
필수
사용자의 이메일 주소입니다. 계정에 member:email:read 권한이 없거나, 구매자가 다른 비즈니스이거나, 사용자에게 할당된 이메일이 없는 경우 null입니다.
string
필수
멤버가 계정에 처음 가입한 시점으로, ISO 8601 타임스탬프입니다.
string | null
필수
멤버가 계정의 콘텐츠를 마지막으로 연 시점으로, ISO 8601 타임스탬프입니다. 한 번도 연 적이 없는 경우 null입니다.
message | null
필수
last_activity_at에 발생한 일입니다. object는 활동의 종류를 나타냅니다. 계정에 support_chat:read 권한이 없거나 last_activity_at이 null인 경우 null입니다.

속성

string
필수
메시지 ID입니다.
object | null
필수
메시지를 보낸 사람: 멤버 또는 계정 팀의 누군가입니다. 보낸 사람의 계정이 더 이상 존재하지 않는 경우 null입니다.

속성

string
필수
사용자 ID이며, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.
string
필수
공개 사용자 이름입니다.
string
필수
메시지가 전송된 지원 채팅입니다.
string
필수
메시지가 전송된 시점으로, ISO 8601 타임스탬프입니다.
string
필수
항상 message입니다.
string | null
필수
서식이 없는 메시지 텍스트입니다. 첨부 파일만 있는 경우처럼 메시지에 텍스트가 없으면 null입니다.
string | null
필수
멤버와 계정이 마지막으로 상호작용한 시점으로, ISO 8601 타임스탬프입니다. 예를 들어 멤버의 지원 채팅에서 보낸 메시지가 있습니다.
object | null
필수
이 멤버에 저장된 사용자 고유의 키-값 데이터입니다. 설정된 것이 없는 경우 null입니다.
string | null
필수
멤버십에서 파생된, 계정에서 멤버의 최신 수명 주기 상태로, paid_subscriber, canceling, churned 등이 있습니다. 처음 계산될 때까지 null입니다.사용 가능한 옵션: canceling, churned, finished_split_pay, paused, paid_subscriber, paid_once, expiring, joined, left, trialing, pending_entry, renewing, past_due
string | null
필수
most_recent_action이 적용된 시점으로, ISO 8601 타임스탬프입니다. most_recent_action이 null인 경우 null입니다.
string | null
필수
계정이 PATCH /members/:id로 이 고객에게 지정한 이름입니다. 이 멤버의 모든 인보이스에서 사용자 본인의 이름 대신 고객 이름으로 표시됩니다. 계정이 설정하지 않은 경우 null입니다.
string | null
필수
멤버의 전화번호: 체크아웃 시 수집(또는 인증)된 가장 최근 번호이며, 없으면 멤버가 이 판매자와 공유한 계정 번호입니다. 계정에 member:phone:read 권한이 없거나 둘 다 없는 경우 null입니다.
string
필수
멤버가 계정에 속해 있는 동안 joined, 탈퇴한 후 left입니다.사용 가능한 옵션: joined, left
number
필수
토큰 거래로부터 계산된 이 계정에 대한 멤버의 현재 토큰 잔액입니다.
string | null
필수
멤버가 계정의 마케팅 커뮤니케이션 수신을 거부하면 unsubscribed, 구독 중인 동안 null입니다. 멤버만 변경할 수 있습니다.사용 가능한 옵션: unsubscribed
object
필수
멤버가 계정의 상품에 지출한 금액(USD)입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
이 멤버의 실제 사용자입니다. 구매자가 개인이 아닌 다른 비즈니스인 경우 null입니다.

속성

string
필수
사용자 ID이며, 접두사는 user_입니다.
string | null
필수
IP 주소에서 파생된 사용자의 도시입니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 null입니다.
string | null
필수
IP 주소에서 파생된 사용자의 국가로, US와 같은 ISO 3166-1 alpha-2 코드입니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 null입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.
string | null
필수
IP 주소에서 파생된 사용자의 주 또는 지역 코드로, CA 등이 있습니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 null입니다.
string
필수
공개 사용자 이름입니다.
Member