Endpoint — détail : connectivité service
Déclaration normalisée d'un point d'accès technique : REST, messaging FHIR, SMTP Direct, DICOM WADO-RS. Cœur des annuaires de santé fédérés.
Rôle de l'Endpoint
Endpoint sert à publier où et comment joindre techniquement un service. Référencé par Organization, Location, HealthcareService, PractitionerRole pour assembler un annuaire opposable aux apps tierces (SMART on FHIR, partage HIE).
Champs clés
| Champ | Cardinalité | Rôle |
|---|---|---|
status | 1..1 | active | suspended | error | off | entered-in-error | test. |
connectionType | 1..* | Protocole(s) supporté(s). En R5, devenu cardinalité multiple pour les services polyglottes. |
name | 0..1 | Nom humain. |
managingOrganization | 0..1 | Organisation responsable. |
payloadType | 0..* | Types de payload acceptés (any, FHIR Patient, IHE XDR). |
payloadMimeType | 0..* | MIME types acceptés. |
address | 1..1 | URL ou URI réel du service. |
connectionType : protocoles supportés
Codes du endpoint-connection-type CodeSystem :
hl7-fhir-rest— API REST FHIR.hl7-fhir-msg— messaging FHIR (Bundle MessageHeader).ihe-xcpd,ihe-xca,ihe-xdr,ihe-xds— profils IHE.dicom-qido-rs,dicom-stow-rs,dicom-wado-rs— DICOMweb.direct-project— secure email Direct.secure-email— SMTPS.
Exemple : EHR REST endpoint
{
"resourceType": "Endpoint",
"id": "ehr-acme-fhir-rest",
"status": "active",
"connectionType": [{
"system": "http://terminology.hl7.org/CodeSystem/endpoint-connection-type",
"code": "hl7-fhir-rest",
"display": "HL7 FHIR REST"
}],
"name": "ACME Healthcare FHIR R5 endpoint",
"managingOrganization": { "reference": "Organization/acme-healthcare" },
"contact": [{
"system": "email",
"value": "fhir-support@acme-health.example.com"
}],
"period": { "start": "2024-01-01" },
"payloadType": [{
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/endpoint-payload-type",
"code": "any"
}]
}],
"payloadMimeType": ["application/fhir+json", "application/fhir+xml"],
"address": "https://fhir.acme-health.example.com/R5"
}Pièges courants
- address sans schéma — toujours préfixer (https://, mailto:, dicom://).
- connectionType ambigu — un endpoint REST FHIR doit utiliser
hl7-fhir-rest, passecure-email. - status pas mis à jour — un endpoint
activeen panne casse les apps cliente. Honorer le statuterrorsur incident. - Pas de SecurityEndpoint — pour SMART on FHIR, le client doit récupérer la conformité OAuth via
.well-known/smart-configuration, pas via Endpoint.