회원 객체

속성

  • 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 integer access_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
    }
  ]
}