Hors ligne

Sans réseau, votre serveur décide avec sa copie locale, puis remonte les passages.

Si la plateforme ne répond pas, votre serveur décide seul avec sa copie locale, en appliquant les mêmes vérifications dans le même ordre que la décision en ligne. Au retour du réseau, il remonte les passages :

POST/partners/gates/api/v1/gates/scans

{
  "siteId": "0199…",
  "scans": [
    {
      "id": "0199d0a1-7c5e-7b9a-9f00-1a2b3c4d5e6f",
      "sessionId": "0199…",
      "credentialKind": "WRISTBAND_UID",
      "credentialValue": "6EC387C8",
      "ticketId": "0199…",
      "decision": "GRANTED",
      "readMode": "UID",
      "scannedAt": "2026-12-26T19:42:07.120Z",
      "passConfirmed": true,
      "confirmedAt": "2026-12-26T19:42:09.000Z",
      "scannerLabel": "Tripode 3"
    }
  ]
}

Champ	Obligatoire	Sens
`id`	oui	UUID unique du passage ; reprenez le `requestId` si une demande était partie
`sessionId`	oui	jour du droit utilisé
`credentialKind`	oui	`WRISTBAND_UID` pour un bracelet
`credentialValue`	oui	l'UID lu
`ticketId`	non	le billet reconnu par votre serveur (`holderId`)
`decision`	oui	`GRANTED` ou `DENIED`
`reason`	si refus	un motif de la décision en ligne, ou `NOT_ACTIVATED`
`readMode`	oui	`UID`
`scannedAt`	oui	heure du passage
`passConfirmed`	non	passage effectif, pour un accord seulement, avec `confirmedAt`

Règles

1 000 passages par envoi au plus, 2 Mo.
Chaque passage n'est compté qu'une fois : un lot renvoyé, ou envoyé deux fois, ne double rien. Un passage déjà décidé en ligne avec le même identifiant est simplement ignoré.
Pour chaque passage, dans l'ordre, la réponse donne RECORDED, DUPLICATE ou REJECTED avec un code : UNKNOWN_SESSION, UNKNOWN_CHECKPOINT ou INVALID_SCAN. Un passage rejeté ne doit pas être renvoyé tel quel.

{
  "data": {
    "siteId": "0199…",
    "recorded": 1,
    "duplicates": 0,
    "rejected": 0,
    "results": [{ "id": "0199d0a1-…", "status": "RECORDED" }]
  }
}

RèglesCopier le lien

Sur cette page

Règles