Salvare i check-in

Crea record di check-in. L'API rimuove automaticamente i duplicati in base a membro, struttura e timestamp.

Parametri

• check_ins array obbligatorio

  Array di oggetti Check-In da salvare. Massimo consigliato: 1000 elementi per richiesta, per prestazioni ottimali. L'API suddivide automaticamente gli elementi in batch per l'elaborazione. Ogni elemento deve includere facility_id (obbligatorio se non usi linking_identifier) oppure linking_identifier (obbligatorio se non usi facility_id).

Valore restituito

Restituisce un semplice messaggio di conferma dell'operazione di sincronizzazione.

Richiesta

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

Risposta

Restituisce un messaggio di esito positivo con i metadati dell'operazione di sincronizzazione.

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

Campi dei metadati:

• success - Numero di check-in elaborati correttamente
• skipped - Numero di check-in saltati (se presenti)
• skipped_items - Array dei check-in saltati con i relativi motivi (se presenti)
• dry-run - Flag booleano presente se usi il tipo di chiave dryrun (se applicabile)