चेक-इन सहेजें

चेक-इन रिकॉर्ड बनाता है। 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 कुंजी प्रकार का उपयोग करने पर बूलियन फ़्लैग (यदि लागू हो)