API du SMT : modification du schéma de données, dépréciations et futures suppressions
Le SMT évolue régulièrement et les API mises à disposition des développeurs suivent ces évolutions. Le Centre de Gestion des Terminologies de Santé fait le point sur la dernière modification du schéma de données, et la suppression à venir de certaines API déjà dépréciées.
Modification du schéma de données
Le SMT est mis à jour en version 6.0 pour préparer l’arrivée de la SNOMED CT dans le catalogue.
Aucune API n’a été dépréciée, mais des modifications ont été effectuées dans le schéma de données pour tenir compte des particularités des licences d’affiliation permettant l’accès aux éditions de la SNOMED CT.
La description des API a été mise à jour.
Les modifications notables au niveau du schéma sont :
- Ajout de l’élément
TerminologyLicence
permettant de décrire la licence d’une terminologie - Modification des éléments
TerminologyMetadataSummaryPublic
etTerminologyMetadataAllPublic
permettant de décrire une terminologie- Dépréciation de l’attribut
licence
- Ajout de l’attribut
licences
(un tableau deTerminologyLicence
) - Ajout de l’attribut
snomedCT
indiquant si la terminologie est une édition SNOMED CT ou non
- Dépréciation de l’attribut
- Modification de l’élément
TerminologyMetadataForSelector
- Ajout de l’attribut
licences
(un tableau deTerminologyLicence
) - Ajout de l’attribut
snomedCT
indiquant si la terminologie est une édition SNOMED CT ou non - Ajout de l’attribut
userHasAccessToConcepts
indiquant si l’utilisateur a le droit d’accéder aux concepts de cette terminologie
- Ajout de l’attribut
Futures suppressions d’API
Un certain nombre d’API du SMT qui ont été dépréciées lors de mises à jour précédentes du SMT vont être supprimées en deux temps.
Les API suivantes seront supprimées avec la version 7 du SMT dont la mise en production est prévue d’ici fin 2023 (entre septembre et décembre 2023) :
GET /api/concepts/search
est dépréciée depuis la version 4 du SMT, il faut maintenant utiliserPOST /api/concepts/search
GET /wp-json/ans/terminologies/versions
est dépréciée depuis la version 5.0 du SMT, il faut maintenant utiliserGET /wp-json/ans/terminologies/versions-details
Les API suivantes seront supprimées avec la version du SMT qui suivra quelques mois après :
GET /api/concepts/search/advanced
etPOST /api/concepts/search/advanced
sont dépréciées depuis la version 5.1 du SMT, il faut maintenant utiliserPOST /api/concepts/search/boolean
POST /api/concepts/search/advanced/code
est dépréciée depuis la version 5.1 du SMT, il faut maintenant utiliserPOST /api/concepts/search/code