שמירת צ׳ק-אינים
יוצר רשומות צ׳ק-אין. ה-API מסיר כפילויות באופן אוטומטי על סמך החבר, המתקן וחותמת הזמן.
פרמטרים
-
check_ins
arrayחובהמערך של אובייקטי Check-In לשמירה. מקסימום מומלץ: 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 (אם רלוונטי)