Référentiel : praticiens

Les praticiens de l'établissement.

GET/config/practitioners

Base : {editorBaseUrl}/api/apiborneIntegrationService/v1Auth : X-Kiosk-Auth-Key seule

Pourquoi cette route existe

Cibler l'accueil par praticien : un message patient peut ne viser que les RDV du Dr MARTIN (consignes propres à sa vacation, par exemple), et les sélecteurs de l'admin listent vos praticiens au lieu d'ids bruts. L'id doit être celui du practitionerId de vos RDV.

Le rppsId est optionnel mais précieux : il permet le rapprochement avec les prescripteurs remontés par la route « médecin traitant / prescripteur » du contrat.

Comment l'appeler

L'appelant est le serveur ApiBorne — jamais une borne : un GET sous votre base contrat, authentifié par la seule clé d'autorisation compte dans X-Kiosk-Auth-Key (admin ApiBorne, page Connectivité), sans X-Kiosk-Device-Id. Il l'appelle à l'activation de l'intégration (sonde config-check) puis à chaque ouverture des pages d'admin qui s'appuient sur ce référentiel.

bash

# AUTH_KEY = la clé d'autorisation compte (admin ApiBorne, page Connectivité)
# L'appelant est le serveur ApiBorne — jamais une borne
curl -sS "$EDITEUR/api/apiborneIntegrationService/v1/config/practitioners" \
  -H "X-Kiosk-Auth-Key: $AUTH_KEY"

Ce que vous devez retourner

200

{ "practitioners": [
  { "id": "4", "name": "Dr Alice MARTIN", "rppsId": "10000000001" },
  { "id": "9", "name": "Dr Paul BERNARD" }
] }

id — le même que le practitionerId des RDV du contrat
rppsId — optionnel — utile au rapprochement avec les prescripteurs

Toujours un 200 avec l'enveloppe ci-dessus — liste vide acceptée (établissement neuf). Schéma complet dans le swagger des routes de configuration.

Implémentation de référence

src/app/api/apiborneIntegrationService/v1/config/practitioners/route.ts →