Binary — Conteneur de contenu opaque
Binary transporte un payload non structuré : PDF de lettre de sortie, image DICOM, audio de consultation, signature numérique. Référencée par DocumentReference, Attachment et Bundle.
Objet de la ressource
Binary est la voie standard pour transporter du contenu non structuré au sein d'un
serveur FHIR. Deux modes d'utilisation : en JSON via data (base64),
ou via accès direct REST sur l'URL /Binary/[id] avec négociation de
contenu HTTP.
Champs clés
| Champ | Type | Cardinalité | Rôle |
|---|---|---|---|
contentType | code (MIME) | 1..1 | Type MIME du contenu (application/pdf, image/jpeg, application/dicom). |
securityContext | Reference(Any) | 0..1 | Contexte de sécurité — sert au moteur d'autorisation. Patient ou Encounter typiquement. |
data | base64Binary | 0..1 | Données encodées base64 inline (taille raisonnable seulement). |
Exemple JSON
Lettre de sortie PDF embarquée :
{
"resourceType": "Binary",
"id": "discharge-letter-pdf",
"contentType": "application/pdf",
"securityContext": { "reference": "Encounter/stay-12345" },
"data": "JVBERi0xLjcKCjEgMCBvYmoKPDwgL1R5cGUgL0NhdGFsb2cgL1BhZ2VzIDIgMCBSID4+CmVuZG9iagovL0F2YWlsYWJsZSBhcyBpbmxpbmUgZGF0YSwgYmFzZTY0LWVuY29kZWQ="
}API REST
POST /Binaryavec body raw +Content-Type: application/pdf— création directe sans JSON wrapper.GET /Binary/[id]avecAccept: application/pdf— récupère le contenu binaire raw.GET /Binary/[id]avecAccept: application/fhir+json— récupère le wrapper JSON avecdatabase64.
Pièges courants
- Tout passer en JSON inline : pour les gros fichiers (> 1 MB), préférer l'accès REST direct ou DocumentReference + Attachment.url externe.
- SecurityContext oublié : sans contexte, le moteur d'autorisation ne sait pas qui peut accéder.
- Base64 corrompu : certains middlewares (gateways) re-encodent — vérifier l'intégrité (hash) après transit.
Ressources liées
- DocumentReference — pointer + métadonnées vers un Binary clinique.
- Attachment — type de donnée FHIR pour intégrer un binaire (avec
urlvers Binary). - Bundle — peut référencer Binary par
fullUrl. - Media — déprécié en R5, photos/vidéos cliniques migrent vers DocumentReference + Binary.
Voir aussi : DocumentReference, Bundle.