كائن العضو

السمات

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