كائن العضو
السمات
-
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) - الرمز البريدي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
}
]
}