Menyimpan check-in
Membuat catatan check-in. API secara otomatis menghapus duplikat berdasarkan anggota, fasilitas, dan stempel waktu.
Parameter
-
check_ins
arraywajibArray objek Check-In yang akan disimpan. Maksimum yang disarankan: 1000 item per permintaan untuk kinerja optimal. API secara otomatis mengelompokkan item ke dalam batch untuk diproses. Setiap item harus menyertakan
facility_id(wajib jika tidak menggunakanlinking_identifier) ataulinking_identifier(wajib jika tidak menggunakanfacility_id).
Hasil
Mengembalikan pesan sederhana yang mengonfirmasi operasi sinkronisasi.
Permintaan
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"
}
]
}'
Respons
Mengembalikan pesan keberhasilan beserta metadata tentang operasi sinkronisasi.
{
"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"
}
]
}
}
Bidang metadata:
- success - Jumlah check-in yang berhasil diproses
- skipped - Jumlah check-in yang dilewati (jika ada)
- skipped_items - Array check-in yang dilewati beserta alasannya (jika ada)
- dry-run - Penanda boolean jika menggunakan jenis kunci dryrun (jika berlaku)