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:
- Recherchez tous les concepts ayant un libellé en anglais (en) commençant par le mot « bea » : http://agrovoc.fao.org/browse/rest/v1/search/?query=bea*&lang=en
- Recherchez tous les concepts ayant un libellé en anglais (en) contenant le mot « bea » : http://agrovoc.fao.org/browse/rest/v1/search/?query=*bea*&lang=en
- Obtenez toutes les données associées au concept http://aims.fao.org/aos/agrovoc/c_3077 : http://agrovoc.fao.org/browse/rest/v1/data/?uri=http://aims.fao.org/aos/agrovoc/c_3077
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.