Boîte à outils

Exploiter les ressources terminologiques Loterre via des web services.

L’Inist propose une série de web services accessibles sur internet. Ces web services permettent de lancer des traitements de "Text and Data Mining" (TDM, fouille de textes), d'extraction de termes, d'enrichissement de données, etc.

Certains web services utilisent les ressources terminologiques Loterre et sont de trois types :

  • • "Identify" : permet de récupérer l'URI (identifiant ARK) d'un concept ;
  • • "Expand" : permet de récupérer toutes les données terminologiques (termes, définitions, relations, etc.) d'un concept ;
  • • "Annotate" : permet d'annoter un texte avec des concepts Loterre.

Ces web services comme tous ceux référencés sur le site ISTEX TDM peuvent s’utiliser de plusieurs manières, de la plus simple à la plus technique, suivant vos besoins et vos compétences :

Avec TDM Factory

TDM Factory est une interface de chargement de corpus et d’exécution de nos web services de TDM (Text and Data Mining). Elle permet d’exploiter vos données en 3 étapes :

  • • Téléchargez vos données et choisissez le format et le champ à traiter,
  • • Choisissez le web service de TDM que vous voulez exécuter,
  • • Renseignez votre adresse mail.

À l’issue du traitement vous recevrez un mail avec un lien de téléchargement du résultat.

Avec Lodex

Ils sont tous compatibles avec l’outil Lodex, outil de visualisation en open source. Avec un simple copier-coller dans un formulaire dédié aux enrichissements, il est possible de traiter un corpus de documents ou l’ensemble des lignes d’un fichier tabulé.

Par programme

Les web services sont tous compatibles avec la norme OpenAPI, il est donc possible de les utiliser avec tous les logiciels compatibles avec cette norme, mais également avec tous les langages informatiques qui permettent d’utiliser des API

curl -X 'POST' \
  'https://loterre-resolvers.services.istex.fr/v1/P66/identify' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '[
  {
    "id": 1,
    "value": "amygdala"
  },
  {
    "id": 2,
    "value": "frontal lobe"
  },
  {
    "id": 3,
    "value": "metamemory"
  }
]'

Réponse :

[
  {
    "id": 1,
    "value": {
      "about": "http://data.loterre.fr/ark:/67375/P66-W52CFWZ4-9",
      "prefLabel@fr": "amygdale",
      "prefLabel@en": "amygdala",
      "localization@en": [],
      "localization@fr": []
    }
  },
  {
    "id": 2,
    "value": {
      "about": "http://data.loterre.fr/ark:/67375/P66-KHRWNS4W-Q",
      "prefLabel@fr": "lobe frontal",
      "prefLabel@en": "frontal lobe",
      "localization@en": [],
      "localization@fr": []
    }
  },
  {
    "id": 3,
    "value": {
      "about": "http://data.loterre.fr/ark:/67375/P66-RGFWPLNW-K",
      "prefLabel@fr": "métamémoire",
      "prefLabel@en": "metamemory",
      "localization@en": [],
      "localization@fr": []
    }
  }
]

Documentation

Le site ISTEX TDM propose une fiche descriptive avec un exemple d’utilisation pour chaque web service. Chaque web service dispose également d’une documentation technique compatible Swagger. Celle-ci permet de connaître les éventuels paramètres avancés pour chaque service mais elle permet surtout de tester rapidement chaque service, à partir d’un simple formulaire.

Code source

Les services sont proposés à travers une infrastructure technique, sans qu’il soit nécessaire de les installer localement. Néanmoins, l’Inist propose un dépôt git qui permet de consulter les codes sources nécessaires à l’exécution des services sur son infrastructure : https://gitbucket.inist.fr/tdm/web-services/tree/master/loterre-resolvers. Vous retrouverez le lien direct vers le code dans chaque fiche de web service.

L’Inist ne propose pas de support à l’installation des services, mais est ouvert à toutes les contributions.

 

Services de contrôle de fichiers SKOS/RDF-XML
Services :
Services de transformation de fichiers CSV ou SKOS/RDF-XML
Services (cliquer sur les catégories de services pour les déplier/replier) :
Interrogez le triplestore grâce à des requêtes SPARQL.
Accès par API aux données du triplestore de Loterre.

Une API (Application Programming Interface) est une interface permettant à un agent logiciel distant d’interroger une base de données et de récupérer les données obtenues en réponse.

Un service d’accès par API aux données du triplestore de Loterre est disponible, par le biais de l’API REST développée pour Skosmos :

  • l’URL de la racine de l’API de Loterre est : https://loterre.istex.fr/rest/v1/
  • les modalités d’utilisation de l’API sont détaillées dans la documentation (en anglais) : http://api.finto.fi/doc/
Quelques exemples de requêtes :
  • Liste des vocabulaires contenus dans le triple store, en anglais, au format JSON-LD

/rest/v1/vocabularies?lang=en

 

  • Nombre de libellés par langue, pour le vocabulaire « Electronique », au format JSON-LD

/rest/v1/RDR/labelStatistics

 

  • Liste des concepts du vocabulaire « Préhistoire-Protohistoire » dont le libellé anglais comporte un mot commençant par la lettre B, au format JSON-LD

/rest/v1/905/search?query=B*&lang=en