Inist offers a series of web services accessible online. These web services allow you to run Text and Data Mining (TDM) processes, extract terms, enrich data, and more.

Some web services use Loterre terminology resources and fall into three categories:

• • Identify: Allows you to retrieve the URI (ARK identifier) ​​of a concept;
• • Expand: Allows you to retrieve all terminological data (terms, definitions, relationships, etc.) for a concept;
• • Annotate: Allows you to annotate a text with Loterre concepts.

All web services referenced on the ISTEX TDM website can be used in several ways, from the simplest to the most technical, depending on your needs and skills:

With TDM Factory

With Lodex

They are all compatible with the Lodex tool, an open-source visualization tool. With a simple copy and paste into a form dedicated to enrichments, it is possible to process a corpus of documents or all the lines of a tabbed file.

Programmatically

Web services are all compatible with the OpenAPI standard, so they can be used with any software that supports this standard, as well as with any computer language that allows APIs.

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"
  }
]'

Response:

[
  {
    "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

The ISTEX TDM website offers a fact sheet with a usage example for each web service. Each web service also has Swagger-compatible technical documentation. This allows you to view the possible advanced settings for each service, but above all, it allows you to quickly test each service using a simple form.

Source Code

The services are offered through a technical infrastructure, without the need to install them locally. However, Inist offers a Git repository that allows you to consult the source code required to run the services on its infrastructure: https://gitbucket.inist.fr/tdm/web-services/tree/master/loterre-resolvers. You will find the direct link to the code in each web service file.

Inist does not provide support for installing the services, but is open to all contributions.

An API (Application Programming Interface) is an tool allowing a remote software agent to query and retrieve data from a database.

An API access to Loterre triplestore is available by means of the REST API developed for Skosmos:

• the Base URL of the API is: https://loterre.istex.fr/rest/v1/
• for information on how to use the Skosmos API, see documentation: http://api.finto.fi/doc/

Examples of requests

• A list, in English, of the vocabularies stored in the triplestore, formated in JSON-LD

/rest/v1/vocabularies?lang=en

• The number of labels per language for the “Electronic” vocabulary, formated in JSON-LD

/rest/v1/RDR/labelStatistics

• The list of the concepts of the “Prehistory-Protohistory” vocabulary for which the English label includes a word beginning with the letter B, formated in JSON-LD

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