บันทึกการเช็กอิน
สร้างเรคคอร์ดการเช็กอิน 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 (ถ้ามี)