Aller au contenu
signatik
Créer un compte

Émargement

Une session en une requête, aucun PDF à fournir : la feuille est générée, scellée une seule fois, exportable pour le financeur.

1. Créer la session

curl -X POST https://preprod.signatik.com/api/v1/attendance-sessions -H "Authorization: Bearer sk_live_…" -H "Content-Type: application/json" -d '{
  "name": "Habilitation électrique B1V — septembre", "reference": "SESS-2026-0912",
  "modality": "onsite", "location": "Lyon, salle 3",
  "trainer": { "name": "Marie Leroy", "email": "marie@of.fr" },
  "slots": [
    { "label": "Jour 1 — matin",      "starts_at": "2026-09-15T09:00:00+02:00", "ends_at": "2026-09-15T12:30:00+02:00" },
    { "label": "Jour 1 — après-midi", "starts_at": "2026-09-15T14:00:00+02:00", "ends_at": "2026-09-15T17:30:00+02:00" }
  ],
  "attendees": [{ "name": "Jean Dupont", "email": "jean.dupont@exemple.fr", "external_ref": "STG-8891" }],
  "retention_days": 1095
}'
# → 201 : attendees[].sign_url (valable toute la session), trainer.url (espace formateur)

2. Pendant la formation

Le formateur ouvre le créneau depuis son espace (ou vous, par POST …/slots/:slotId/open). Le QR code projeté change toutes les trente secondes ; les stagiaires le scannent ou utilisent leur lien personnel. GET /attendance-sessions/:id donne le taux de présence par créneau en temps réel.

Règle non négociable
Un créneau clos ne peut plus être rempli, jamais. Un émargement hors de la fenêtre du créneau est accepté mais marqué out_of_window: true dans la preuve.

3. Clôturer

curl -X POST https://preprod.signatik.com/api/v1/attendance-sessions/ses_…/close -H "Authorization: Bearer sk_live_…"
# → feuille générée, UN scellement, UN dossier de preuve ; webhook attendance.session_closed
curl https://preprod.signatik.com/api/v1/attendance-sessions/ses_…/sheet  -H "Authorization: Bearer sk_live_…"   # liens 1 h
curl https://preprod.signatik.com/api/v1/attendance-sessions/ses_…/export -H "Authorization: Bearer sk_live_…"   # CSV

Coût et rétention

0,75 crédit par stagiaire et par session, tous créneaux compris, débité à la clôture. Rétention de trois ans par défaut (30 à 3 650 jours) ; la feuille scellée reste vérifiable par empreinte au-delà.

Référence : émargement →Guide : vérification →