حفظ تسجيلات الدخول
ينشئ سجلات تسجيل الدخول. وتزيل API التكرارات تلقائيًا بناءً على العضو والمنشأة والطابع الزمني.
المعلمات
-
check_ins
arrayمطلوبمصفوفة من كائنات تسجيل الدخول المراد حفظها. الحد الأقصى الموصى به: 1000 عنصر لكل طلب لتحقيق أفضل أداء. تقسّم API العناصر إلى دفعات تلقائيًا لمعالجتها. يجب أن يتضمن كل عنصر إما
facility_id(مطلوب إذا لم تستخدمlinking_identifier) أوlinking_identifier(مطلوب إذا لم تستخدمfacility_id).
القيم المُرجعة
يُرجع رسالة بسيطة تؤكد عملية المزامنة.
الطلب
curl -X POST https://partner-api.performancehub.co/partner/v1/check-ins \
-u sk_live_YOUR_PARTNER_SECRET_KEY: \
-H "Content-Type: application/json" \
-d '{
"check_ins": [
{
// "check_in_id": "checkin_abc123", // Optional - auto-generated from member_id + timestamp if not provided
"member_id": "mem_12345",
"facility_id": "550e8400-e29b-41d4-a716-446655440000",
// "linking_identifier": "branch_downtown", // If using linking identifier
"check_in_type": "member",
"source": "rfid",
"timestamp": "2025-01-20T08:45:30Z"
}
]
}'
الاستجابة
يُرجع رسالة نجاح مع بيانات وصفية حول عملية المزامنة.
{
"message": "Check-in sync successful.",
"metadata": {
"success": 523,
"skipped": 3,
"skipped_items": [
{
"member_id": "member_789",
"facility_id": null,
"reason": "No matching facility_id for the linking_identifier"
}
]
}
}
حقول البيانات الوصفية:
- success - عدد تسجيلات الدخول التي عولجت بنجاح
- skipped - عدد تسجيلات الدخول التي تم تخطيها (إن وجدت)
- skipped_items - مصفوفة من تسجيلات الدخول التي تم تخطيها مع أسباب ذلك (إن وجدت)
- dry-run - علامة منطقية عند استخدام نوع المفتاح dryrun (إن انطبق ذلك)