Enregistrer des entrées

Crée des enregistrements d'entrée. L'API dédoublonne automatiquement les enregistrements en fonction du membre, de l'installation et de l'horodatage.

Paramètres

• check_ins array obligatoire

  Tableau d'objets Check-In à enregistrer. Maximum recommandé : 1000 éléments par requête pour des performances optimales. L'API regroupe automatiquement les éléments en lots pour leur traitement. Chaque élément doit inclure soit facility_id (obligatoire si vous n'utilisez pas linking_identifier), soit linking_identifier (obligatoire si vous n'utilisez pas facility_id).

Valeur renvoyée

Renvoie un message simple confirmant l'opération de synchronisation.

Requête

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

Réponse

Renvoie un message de réussite accompagné de métadonnées sur l'opération de synchronisation.

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

Champs de métadonnées :

• success - Nombre d'enregistrements d'entrée traités avec succès
• skipped - Nombre d'enregistrements d'entrée ignorés (le cas échéant)
• skipped_items - Tableau des enregistrements d'entrée ignorés, avec leurs motifs (le cas échéant)
• dry-run - Indicateur booléen en cas d'utilisation d'une clé de type dryrun (le cas échéant)