Routes de communication
Les opérations que la borne appelle chez vous pendant le parcours patient — une page par opération : sémantique, requête, réponse, erreurs et implémentation de référence. Quatorze routes sont obligatoires — celles dont vous n'avez pas la fonctionnalité acceptent une implémentation minimale (liste vide, 204, 404…) ; une seule est optionnelle, le contenu d'un document : si elle répond 404, la borne masque simplement l'aperçu.
Les 15 opérations
/patients/identifyIdentifier un patient — Recherche les patients et leurs RDV du jour (carte de santé ou saisie).
/appointments/by-code/{code}RDV par code (QR) — Résout le code de convocation scanné par le patient.
/appointments/by-ticketRDV par ticket (app Pass) — Résout un RDV du jour par numéro de ticket + date de naissance (app patient).
/appointments/{appointmentId}RDV par identifiant — Rechargement canonique d'un RDV déjà connu.
/appointments/{appointmentId}/statusStatut d'un RDV — Le Cockpit ApiBorne reflète un changement d'état dans votre agenda.
/patients/{patientId}Modifier un patient — Correction des données administratives depuis la borne.
/appointments/{appointmentId}/prescriberPrescripteur du RDV — Le patient valide un prescripteur proposé par l'analyse d'ordonnance.
/appointments/{appointmentId}/documentsLister les documents — Documents présents et types attendus — la borne calcule les manquants.
/appointments/{appointmentId}/documentsTéléverser un document — Pages images en base64, analyse d'ordonnance optionnelle en retour.
/appointments/{appointmentId}/documents/{documentId}Supprimer un document — Le remplacement d'un document = DELETE de l'ancien puis POST du nouveau.
/appointments/{appointmentId}/documents/{documentId}/contentoptionnelleContenu d'un document (aperçu) — OPTIONNEL — les pages d'un document déjà déposé, pour l'aperçu « Voir » du patient.
/appointments/{appointmentId}/check-inCheck-in — L'opération critique : arrivée du patient, ticket d'appel en retour.
/appointments/{appointmentId}/notify-external-systemNotifier le système externe — Accueil RIS différé : déclencher la notification des équipes pour un RDV déjà accueilli.
/appointments/{appointmentId}/notification-readinessNotification readiness — Le dossier est-il complet au sens de l'éditeur ? Toujours répondre.
/staff/sign-inConnexion du personnel — Login Cockpit avec vos identifiants — appelé par le serveur ApiBorne.
La spécification OpenAPI
La source de vérité normative est openapi.yaml (OpenAPI 3.0.3). Ce guide en reprend la sémantique — en cas de doute, la spec fait foi. Les fichiers se branchent directement sur vos outils (générateurs de clients, Postman, Insomnia, Swagger UI…).