L'API institutionnelle Thésaurus INRAE

Retourne les informations détaillées de tous les concepts correspondant aux filtres de recherche passés en paramètres. /concepts/actifs ne renvoie que les concepts valides et /concepts/inactifs que les concepts dépréciés.

Filtres

• label : sur les termes (prefLabel, altLabel et hiddenLabel en SKOS) des concepts.  Il est possible d’indiquer plusieurs chaînes de recherche en utilisant plusieurs fois ce paramètre. Ex. : /concepts?label=abeille&label=prairie&label=...Il renverra les concepts ayant un terme contenant « abeille » OU « prairie » ;
  Le label peut aussi être recherché avec un joker ( * ) en début, au milieu ou à la fin de la chaîne recherchée. Par exemple, pour recherche les termes finissant par « plant » comme « eggplant » ou « refrigerating plant » : /concepts?label=*plant.
  La recherche est insensible à la casse, aux accents et fonctionne avec un minimum 3 caractères ;
• limit : Nombre d’éléments à retourner par la requête. La valeur est un nombre entier positif (10 par défaut, 500 maximum) ;
• offset : Indice de l’élément de départ dans la collection. Cette indice permet de naviguer dans les résultats lorsque la réponse est composée de plusieurs pages contenant une réponse partielle. La valeur est un nombre entier positif (0 par défaut).

Informations renvoyées

• uri : Identifiant du concept ;
• prefLabels : Etiquette lexicale préférentielle du concept dans une langue donnée
• deprecated : Spécifie si le concept est actif (false) ou inactif (true) ;
• topConceptsOf : Microthésaurus et thésaurus pour lesquels le concept est situé au 1er niveau de la hiérarchie ;
• conceptSchemes : Microthésaurus et thésaurus auxquels appartient le concept ;
• altLabels : Etiquette lexicale alternative (synonyme) du concept ;
• hiddenLabels : Etiquette lexicale cachée, utilisée par le système lors d’opérations de recherche textuelle libre (libellés potentiellement mal orthographiés) afin que l’utilisateur puisse trouver le bon concept, mais qui doit être masquée à l’utilisateur ;
• narrowers: Lien hiérarchique vers un concept plus spécifique ;
• broaders : Lien hiérarchique vers un concept plus générique ;
• definitions : Explication formelle d’un concept dans une langue donnée. La source de la définition est indiquée dans un élément « source » ;
• collections : Groupes nommés de concepts pouvant appartenir à des microthésaurus différents ;
• exactMatches : Identifiant d’une ressource externe au thésaurus, par exemple l’uri d’un concept défini dans un autre thésaurus. La propriété « exactMatch » indique une équivalence entre les 2 ressources, i.e. qu’elles peuvent être utilisés de façon interchangeable dans une large majorité d’applications de recherche d’informations.

Pour plus de détails, consulter la documentation et le modèle de données dans la Console API sur le Plateforme d’intégration.

Retourne les informations détaillées de tous les microthésaurus correspondant aux filtres de recherche passés en paramètres. /microthesaurus/actifs ne renvoie que les microthésaurus valides et /microthesaurus/inactifs que les microthésaurus obsolètes.

Filtres

• uri : Identifiant du ou des microthésaurus à interroger ;
• label : sur les noms (prefLabel, altLabel et hiddenLabel en SKOS) des microthésaurus.  Il est possible d’indiquer plusieurs chaînes de recherche en utilisant plusieurs fois ce paramètre. Ex. : /microthésaurus?label=génétique&label=génomique&label=...Il renverra les microthésaurus ayant un nom contenant « génétique » OU « génomique » ;
  Le nom peut aussi être recherché avec un joker ( * ) en début, au milieu ou à la fin de la chaîne recherchée. Par exemple, pour recherche les noms commençant par « bio » comme « biologie » ou « biologie cellulaire » : /microthésaurus?label=bio*.
  La recherche est insensible à la casse, aux accents et fonctionne avec un minimum 3 caractères ;
• lang : Permet de rechercher le ou les label(s) demandé(s) ci-dessus uniquement dans la ou les langue(s) spécifiée(s) ici.
• limit : Nombre d’éléments à retourner par la requête. La valeur est un nombre entier positif (10 par défaut, 500 maximum) ;
• offset : Indice de l’élément de départ dans la collection. Cette indice permet de naviguer dans les résultats lorsque la réponse est composée de plusieurs pages contenant une réponse partielle. La valeur est un nombre entier positif (0 par défaut).

Informations renvoyées

• uri : Identifiant du ou des microthésaurus ;
• prefLabels : Etiquette lexicale préférentielle du microthésaurus dans une langue donnée ;
• modified : date de dernière mise à jour du microthésaurus
• deprecated : Spécifie si le microthésaurus est actif (false) ou inactif (true) ;
• domain : URI et nom du domaine d’appartenance du microthésaurus
• isPartOf : URI du thésaurus d’appartenance
• hasTopConcepts : URI et prefLabels des concepts de 1er niveau du microthésaurus. Cette donnée est généralement exploitée par les outils d’affichage des thésaurus pour construire la hiérarchie des concepts de manière descendante.
  Important : en version 5 de l’API, seuls l’URI et les prefLabels des concepts sont retournés alors que la version précédentes renvoyait toutes les informations pour chaque concept.

Pour plus de détails, consulter la documentation et le modèle de données dans la Console API sur le Plateforme d’intégration.

Retourne les informations détaillées de toutes les collections (appelés groupes dans l’ancienne version de l’API) correspondant aux filtres de recherche passés en paramètres. /collections/actifs ne renvoie que les collections valides et /collections/inactifs que les collections obsolètes.

Filtres

• uri : Identifiant du ou des collections à interroger ;
• label : sur les noms (prefLabel, altLabel et hiddenLabel en SKOS) des collections.  Il est possible d’indiquer plusieurs chaînes de recherche en utilisant plusieurs fois ce paramètre. Ex. : /collections?label=*alignes&label=*gemet&label=...Il renverra les collections ayant un nom contenant « alignes » OU « gemet ». Le nom peut aussi être recherché avec un joker ( * ) en début, au milieu ou à la fin de la chaîne recherchée. La recherche est insensible à la casse, aux accents et fonctionne avec un minimum 3 caractères ;
• lang : Permet de rechercher le ou les label(s) demandé(s) ci-dessus uniquement dans la ou les langue(s) spécifiée(s) ici.
• limit : Nombre d’éléments à retourner par la requête. La valeur est un nombre entier positif (10 par défaut, 500 maximum) ;
• offset : Indice de l’élément de départ dans la collection. Cette indice permet de naviguer dans les résultats lorsque la réponse est composée de plusieurs pages contenant une réponse partielle. La valeur est un nombre entier positif (0 par défaut).

Informations renvoyées

• uri : Identifiant de la ou des collections;
• prefLabels : Nom de la collection dans une langue donnée ;
• modified : date de dernière mise à jour de la collection
• deprecated : Spécifie si la collection est active (false) ou inactive (true) ;
• notes : texte descriptif de la collection dans chaque langue disponible
• concepts : liste des concepts contenus dans la collection avec leur URI et prefLabel
• collections : URI et nom des sous-collections qu’elle contient 

Pour plus de détails, consulter la documentation et le modèle de données dans la Console API sur le Plateforme d’intégration.

Retourne en une seule requête l’ensemble des données sur une des ressources.

Filtres

• Pas de paramètres : Retourne une liste de fichiers disponibles dans le répertoire configuré. Seuls les fichiers des types configurés (par exemple, xml, json) sont listés.

[
  "collections-actives.json",
  "collections-actives.xml",
  "collections-inactives.json",
  "collections-inactives.xml",
  "collections.json",
  "collections.xml",
  "concepts-actifs.json",
  "concepts-actifs.xml",
  "concepts-inactifs.json",
  "concepts-inactifs.xml",
  "concepts.json",
  "concepts.xml",
  "microthesaurus-actifs.json",
  "microthesaurus-actifs.xml",
  "microthesaurus-inactifs.json",
  "microthesaurus-inactifs.xml",
  "microthesaurus.json",
  "microthesaurus.xml"
]

• name : le nom du fichier avec son extension. Un lien hypertexte « Download file » permet de télécharger le fichier.