Lưu check-in

Tạo các bản ghi check-in. API tự động loại bỏ trùng lặp dựa trên hội viên, cơ sở và dấu thời gian.

Tham số

check_ins array bắt buộc

Mảng các đối tượng Check-In cần lưu. Khuyến nghị tối đa: 1000 mục mỗi yêu cầu để đạt hiệu suất tối ưu. API tự động chia lô các mục để xử lý. Mỗi mục phải có facility_id (bắt buộc nếu không dùng linking_identifier) hoặc linking_identifier (bắt buộc nếu không dùng facility_id).

Giá trị trả về

Trả về một thông báo đơn giản xác nhận thao tác đồng bộ.

Yêu cầu

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"
      }
    ]
  }'

Phản hồi

Trả về thông báo thành công kèm siêu dữ liệu về thao tác đồng bộ.

{
  "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"
      }
    ]
  }
}

Các trường siêu dữ liệu:

success - Số lượt check-in đã được xử lý thành công
skipped - Số lượt check-in bị bỏ qua (nếu có)
skipped_items - Mảng các lượt check-in bị bỏ qua kèm lý do (nếu có)
dry-run - Cờ boolean nếu sử dụng loại khóa dryrun (nếu áp dụng)