ApiBorne
Sommaire du guide

Modifier un patient

L'écran « Vérifions votre identité » de la borne : correction du téléphone, de l'adresse, de la biométrie ou du médecin traitant. Répond 204 sans corps — la borne recharge ensuite le RDV.

PATCH/patients/{patientId}
Base : {editorBaseUrl}/api/apiborneIntegrationService/v1Auth : X-Kiosk-Auth-Key + X-Kiosk-Device-IdRoute obligatoire

Pourquoi cette route existe

L'écran « Vérifions votre identité » de la borne fait plus que vérifier : il corrige. Téléphone, adresse, mensurations, médecin traitant — autant de données administratives que le patient met à jour lui-même, sans mobiliser le guichet. Cette route reporte ces corrections chez vous : votre base patient reste la source de vérité, la borne n'en garde aucune copie. Route obligatoire — l'implémentation minimale conforme applique ce que vous supportez et répond 204.

Sémantique PATCH

  • Seuls les champs présents dans patient changent ;
  • champ absent = inchangé ;
  • null explicite = effacement (si vous le supportez) ;
  • address et referringPractitioner sont des objets imbriqués (line1/line2/zipCode/city, name/rppsId) ;
  • NIR : stockez-le sans espaces.

Requête

bash
curl -sS -X PATCH "$BASE/patients/pat-77" "${AUTH[@]}" -d '{
  "patient": {
    "mobilePhone": "+33612345678",
    "address": { "line1": "12 rue des Lilas", "zipCode": "75011", "city": "Paris" },
    "heightCm": 168, "weightKg": 62
  }
}'
# → 204 (sans corps)

Points d'attention

La borne renvoie le formulaire entier à la sauvegarde, pré-rempli depuis vos données : exposez tous les champs éditables dans vos réponses patient (mobilePhone, adresse complète, heightCm/weightKg, referringPractitioner) — un pré-remplissage manquant se traduirait par un effacement à la sauvegarde.

Implémentation de référence

src/app/api/apiborneIntegrationService/v1/patients/[patientId]/route.ts — PATCH colonne par colonne avec gestion de l'adresse imbriquée.