TerminologyCapabilities — Capacités d'un serveur terminologique
La CapabilityStatement spécifique au module Terminology : quels CodeSystems, ValueSets, ConceptMaps, opérations sont exposés par le serveur, avec quelles versions et quelles options.
Objet de la ressource
TerminologyCapabilities décrit ce qu'un serveur terminologique sait faire :
liste des CodeSystems hébergés avec leurs versions, ValueSets pré-expansés, ConceptMaps
disponibles, support des opérations $expand, $validate-code,
$translate, $lookup, $subsumes, gestion des langues,
de la pagination, etc.
Elle est généralement publiée à l'endpoint /metadata?mode=terminology ou
/.well-known/fhir-configuration, en complément de la CapabilityStatement générale.
Champs clés
| Champ | Type | Cardinalité | Rôle |
|---|---|---|---|
url | uri | 0..1 | URL canonique. |
version | string | 0..1 | Version. |
name | string | 0..1 | Nom technique. |
title | string | 0..1 | Titre. |
status | code | 1..1 | draft | active | retired | unknown. |
date | dateTime | 1..1 | Date de publication. |
kind | code | 1..1 | instance | capability | requirements. |
software | BackboneElement | 0..1 | Software hébergeur. |
implementation | BackboneElement | 0..1 | Instance d'implémentation (URL). |
lockedDate | boolean | 0..1 | Support de la lecture à une date donnée. |
codeSystem | BackboneElement[] | 0..* | CodeSystems hébergés avec leurs versions. |
expansion | BackboneElement | 0..1 | Capacités d'expansion (hierarchical, paging, incomplete). |
codeSearch | code | 0..1 | Filtre sur le search (in-compose | in-expansion). |
validateCode | BackboneElement | 0..1 | Capacités de $validate-code. |
translation | BackboneElement | 0..1 | Capacités de $translate. |
closure | BackboneElement | 0..1 | Capacités de $closure. |
Exemple JSON
{
"resourceType": "TerminologyCapabilities",
"id": "example-term-server",
"url": "http://example.org/TerminologyCapabilities/example-term-server",
"version": "5.0.0",
"name": "ExampleTermServer",
"title": "Example terminology server capabilities",
"status": "active",
"date": "2026-05-15",
"kind": "instance",
"software": {
"name": "HAPI Terminology Server",
"version": "7.0"
},
"codeSystem": [{
"uri": "http://snomed.info/sct",
"version": [{
"code": "http://snomed.info/sct/900000000000207008/version/20260301",
"isDefault": true
}]
}],
"expansion": {
"hierarchical": true,
"paging": true
},
"translation": {
"needsMap": true
}
}Pièges courants
- Versions de CodeSystem absentes — un client ne sait pas si la version de SNOMED CT française de 2026-03 est disponible.
- Confusion avec CapabilityStatement — la CapabilityStatement décrit l'API REST ; TerminologyCapabilities décrit le contenu sémantique.