ApiBorne
Sommaire du guide

printTicket

Réimprimer le ticket d'un patient depuis un poste d'accueil : ApiBorne rend le template de ticket configuré dans son admin, choisit l'imprimante cible (borne du lieu ou imprimante de guichet) et déclenche l'impression.

POST/api/kioskTicket/printTicket
Auth : Authorization = clé d'autorisation compte (brute)

Pourquoi ce service existe

Le format des tickets (template Mustache, variantes par langue) et le matériel (imprimante de borne ou de guichet) sont configurés et pilotés par ApiBorne. Quand votre poste d'accueil doit réimprimer un ticket — patient qui l'a perdu, arrivée pointée au guichet — il ne peut donc pas le faire seul : ce service demande à ApiBorne de rendre le template configuré et de déclencher l'impression sur le bon périphérique.

Authentification : AUTH_KEY et licenceUuid

AUTH_KEY est la « Clé d'autorisation compte » : le secret partagé de l'intégration, affiché dans l'admin ApiBorne → page Connectivité (champ copiable) et remis à votre système à l'installation. C'est la même clé que celle que vous validez en X-Kiosk-Auth-Key sur les appels entrants — ici elle s'envoie dans le header Authorization, brute (sans préfixe Bearer).

Le licenceUuid vient de la même page Connectivité : c'est l'identifiant (pas un secret) qui désigne la licence cible dans le corps de chaque appel.

Provisioning : l'admin ApiBorne (page Connectivité) fournit la clé d'autorisation compte et l'UUID de licence, stockés dans la configuration de l'éditeur.Admin ApiBornepage Connectivité« Clé d'autorisation compte » 🔑« UUID de la licence »copiées UNE FOIS, à l'installationConfiguration de votre systèmeclé → header Authorization (brute)et validation de X-Kiosk-Auth-Keyuuid → corps des appels sortantsLa clé est un SECRET (authentifie) · l'UUID est un identifiant (désigne la licence)
Deux valeurs copiées une fois, à l'installation — la clé authentifie tous les flux, l'UUID désigne la licence dans les appels sortants.

Quand l'appeler

Quand l'accueil réimprime un ticket (patient qui l'a perdu, arrivée pointée au guichet). Le template (Mustache, avec variantes par langue) et le choix du périphérique sont entièrement portés par la configuration ApiBorne : votre système de gestion médical n'envoie que le contexte — lieu, guichet appelant éventuel, et les données du RDV à injecter dans le template (data).

Les clés de data sont celles de vos objets RDV habituels — le rendu Mustache étant sensible à la casse, ApiBorne duplique les clés en Pascal/camel pour rester compatible avec les templates existants.

Requête et réponse

bash
# AUTH_KEY = la clé d'autorisation compte (la même que X-Kiosk-Auth-Key), envoyée BRUTE
curl -sS "$APIBORNE/api/kioskTicket/printTicket" \
  -H "Authorization: $AUTH_KEY" -H 'Content-Type: application/json' -d '{
  "licenceUuid": "ecdb8b76-…",
  "officePlaceId": 1,
  "kioskDeskId": 3,
  "data": {
    "appointmentTicketNumberWithPrefix": "SC-12",
    "patientLastNameFirstName": "DURAND Marie",
    "exam": "SCANNER THORACIQUE"
  }
}'
# → 200 { "printed": true, "deviceExternalId": "KIOSK-042" }