Utilisation machine

Actuellement, il existe trois façons distinctes d'accéder aux données AGROVOC sans passer par une interface utilisateur (UI) :

SPARQL endpoint

https://agrovoc.fao.org/sparql

Skosmos REST APIs

Skosmos  fournit un ensemble de REST APIs pour accéder à ses données de vocabulaire. On peut accéder au déploiement officiel d'AGROVOC Skosmos en cliquant ici. Cette REST API permet, entre autres, de rechercher des concepts à travers leurs libellés, de filtrer ces recherches à l'aide de langages spécifiques (dans le terme recherché ou même dans les données renvoyées) et d'obtenir ensuite toutes les informations relatives à un concept donné.

Voici quelques exemples de REST APIs:

Pour obtenir la liste complète des REST APIs, veuillez consulter guide officiel (official guide).

Services web hérités (moyennant l’utilisation du protocole SOAP)

Les services Web AGROVOC permettent d'accéder aux contenus AGROVOC grâce à la technologie des services Web SOAP. La mise en œuvre actuelle des services Web AGROVOC est alimentée par les données de la version RDF d'AGROVOC (actuellement, la version master est en cours d'édition par VocBench).

Le fichier WSDL pour les services Web se trouve ici : http://agrovoc.fao.org:8080/SKOSWS/services/SKOSWS?wsdl. Ci-dessous, figure une liste des services Web AGROVOC actuellement mis en œuvre, ainsi que leur description.

AGROVOC est également accessible via SPARQL. Veuillez consulter la page AGROVOC Release pour accéder au  SPARQL endpoint.

Note: Les services Web AGROVOC sont alimentés par la version "Linked Open Data" (LOD) d'AGROVOC (voir Releases), qui comprend également des triplets relatifs à ce qui suit :

  • Le vocabulaire de l’ontologie Agrontology,
  • Les cartographies,
  • des triplets inférés trivialement et produits automatiquement, etc.

Liste des services Web SOAP

Les services Web suivants ont été mis en place pour faciliter l'accès au contenu d'AGROVOC par le biais de clients SOAP dédiés.

  • getConceptByKeyword
  • getConceptByKeyword2
  • searchByModeLangScopeXML
  • simpleSearchByMode2
  • getConceptInfoByTermcode
  • getConceptInfoByURI
  • getDefinitions
  • getAllLabelsByTermcode2
  • getTermByLanguage
  • getURIByTermAndLangXML
  • getFullAuthority
  • getConceptByURI
  • getConceptByRelationshipValue
  • getlatestUpdates
  • getTermcodeByTermAndLangXML
  • getTermExpansion
  • getReleaseDate
  • getWebServicesVersion

Nous ne prévoyons pas d'ajouter d'autres services web à l'avenir, et nous recommandons plutôt l'accès à AGROVOC par le biais du SPARQL endpoint actuel.