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 et TerminologyMetadataAllPublic permettant de décrire une terminologie
    • Dépréciation de l’attribut licence
    • Ajout de l’attribut licences (un tableau de TerminologyLicence)
    • Ajout de l’attribut snomedCT indiquant si la terminologie est une édition SNOMED CT ou non
  • Modification de l’élément TerminologyMetadataForSelector
    • Ajout de l’attribut licences (un tableau de TerminologyLicence)
    • 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

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 utiliser POST /api/concepts/search
  • GET ​/wp-json​/ans​/terminologies​/versions est dépréciée depuis la version 5.0 du SMT, il faut maintenant utiliser GET /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 et POST /api/concepts/search/advanced sont dépréciées depuis la version 5.1 du SMT, il faut maintenant utiliser POST /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 utiliser POST /api/concepts/search/code