회원 객체
속성
-
member_id
string필수회원의 고유 식별자입니다.
-
facility_id
string둘 중 하나통합에 구성된 시설 식별자 유형을 제공하십시오. 직접 연결 통합에는 facility_id를, 연결 식별자 통합에는 linking_identifier를 사용하십시오. 둘 다 보내지 마십시오. API는 파트너 계정에 구성된 식별자 유형을 사용하고 다른 하나는 무시합니다. 자세히 알아보기Performance Hub의 시설 고유 식별자입니다.
-
linking_identifier
string둘 중 하나통합에 구성된 시설 식별자 유형을 제공하십시오. 직접 연결 통합에는 facility_id를, 연결 식별자 통합에는 linking_identifier를 사용하십시오. 둘 다 보내지 마십시오. API는 파트너 계정에 구성된 식별자 유형을 사용하고 다른 하나는 무시합니다. 자세히 알아보기파트너가 각 위치에 사용하는 고유 식별자 값입니다(예: "Branch ID", "Location Code", "Store Number"). 자세히 알아보기
-
first_name
string필수회원의 이름입니다.
-
last_name
string필수회원의 성입니다.
-
email
string선택이메일 주소입니다.
-
mobile_phone
string선택E.123 형식의 휴대폰 번호입니다(예:
"+1 415 555 2671"). -
address
object선택다음 속성을 가진 실제 주소 객체입니다.
address_line_1(string) - 기본 도로명 주소address_line_2(string, optional) - 보조 주소 줄city(string) - 도시 이름state(string) - 주/도 코드postal_code(string) - 우편번호/ZIP 코드country(string) - ISO 3166-1 alpha-2 국가 코드(예: "AU", "US")country_name(string, optional) - 전체 국가 이름
-
date_of_birth
string선택YYYY-MM-DD형식의 생년월일입니다. -
gender
string선택male,female,non_binary,prefer_not_to_say,unknown중 하나입니다. -
type
string선택회원 유형입니다(예:
staff,member,prospect). -
tags
array선택특정 회원을 분류하고 식별하기 위한 간단한 도우미 문자열 또는 텍스트입니다(예:
["vip", "personal-training", "student"]). -
membership_status
string선택현재 멤버십 상태입니다(예:
active,expired,on_hold). -
membership_plans
array선택회원과 연결된 멤버십 플랜의 배열입니다.
-
profile_picture
string선택Base64로 인코딩된 프로필 사진입니다(선택 사항).
-
created
string선택회원이 생성된 시각의 ISO 8601 타임스탬프입니다.
-
updated
string선택회원이 마지막으로 업데이트된 시각의 ISO 8601 타임스탬프입니다.
-
access_time_windows
array선택절대 및/또는 주간 반복 Access Time Windows에 대한 원본 소유의 완전한 스냅샷입니다. 스냅샷을 변경하지 않으려면 필드를 생략하고, 취소하려면 더 새로운 리비전과 함께 빈 배열을 보내십시오. 형식, 유효성 검사, 범위 매핑, 대체 의미 체계는 Access Time Windows를 참조하십시오.
-
access_time_windows_revision
integeraccess_time_windows와 함께 필수이 회원/원본 스트림에 대해 단조 증가하는, 음수가 아니고 JSON에서 안전한 정수입니다.
access_time_windows가 있을 때마다 필수입니다.
회원 객체
{
"member_id": "member_11111",
"facility_id": "550e8400-e29b-41d4-a716-446655440000",
// "linking_identifier": "branch_downtown", // If using linking identifier
"first_name": "John",
"last_name": "Smith",
"email": "john.smith@example.com",
"mobile_phone": "+61 412 345 678",
"date_of_birth": "1985-06-15",
"gender": "male",
"type": "member",
"tags": ["vip", "personal-training"],
"profile_picture": "/9j/4AAQSkZJRgABAQAAAQ...",
"membership_status": "current",
"created": "2024-01-15T10:30:00Z",
"updated": "2024-01-20T14:45:00Z",
"access_time_windows_revision": 1842,
"access_time_windows": [
{
"external_id": "access-4b1782",
"kind": "absolute",
"from": 1792053000,
"to": 1792058400,
"timezone": "Australia/Perth",
"scope_key": "after_hours_entry",
"label": "Temporary site access"
}
],
"address": {
"address_line_1": "456 Bourke Street",
"address_line_2": "Apt 12",
"city": "Melbourne",
"state": "VIC",
"postal_code": "3000",
"country": "AU",
"country_name": "Australia"
},
"membership_plans": [
{
"membership_plan_id": "plan_99999",
"name": "Unlimited Monthly",
"start_date": "2024-01-01T00:00:00Z",
"status": "current",
"is_current": true,
"end_date": null
}
]
}