« Project:API/fr » : différence entre les versions

De Référentiels d’autorité Biblissima
Aller à la navigation Aller à la recherche
(Mise à jour pour être en accord avec la nouvelle version de la source de la page)
(Mise à jour pour être en accord avec la nouvelle version de la source de la page)
 
Ligne 3 : Ligne 3 :




La publication des référentiels d’autorité Biblissima s’inscrit dans une démarche d’ouverture et de réutilisation des données. Ainsi cette plateforme met à disposition des données sous une forme structurée et exploitable par des programmes informatiques via des '''services web''' (ou API Web).
'''La documentation des API est désormais disponible sur le site de documentation de Biblissima (rubrique API) : https://doc.biblissima.fr/api/'''


{{Note|class=info|texte=Pour obtenir des explications plus détaillées, vous pouvez contacter l’équipe Biblissima à l’adresse [mailto:team@biblissima-condorcet.fr team@biblissima-condorcet.fr]}}
{{Note|class=info|texte=Pour obtenir des explications plus détaillées sur les API, vous pouvez aussi contacter l’équipe Biblissima+ à l’adresse [mailto:team@biblissima-condorcet.fr team@biblissima-condorcet.fr]}}
 
== API Mediawiki/Wikibase ==
 
La plateforme data.biblissima.fr dispose des mêmes accès par API que Wikidata ou les autres instances de Mediawiki/Wikibase :
 
* '''URL du point d'accès et de la documentation de l'API : https://data.biblissima.fr/w/api.php'''
* '''Bac à sable''' pour expérimenter l’API (interrogation guidée au moyen d’un formulaire) : https://data.biblissima.fr/w/Spécial:ApiSandbox
 
Lire la documentation officielle :
* [https://www.mediawiki.org/wiki/API:Main_page/fr API action de MediaWiki]
* [https://www.mediawiki.org/wiki/Wikibase/API/fr API Wikibase]
 
== Interface de données liées (RDF) ==
 
Chaque entité ou propriété au sein de la plateforme est identifiée dans le Web de données par une '''URI''' construite sous la forme suivante : <pre>https://data.biblissima.fr/entity/Q{id}</pre>
 
Exemple : https://data.biblissima.fr/entity/Q2785
 
Les données brutes d’une entité individuelle sont disponibles au format '''JSON''' et dans différentes sérialisations de '''RDF''' : RDF/XML, N-Triples, Turtle et N3.
 
Elles sont accessibles de deux façons :
# par le mécanisme de [https://developer.mozilla.org/fr/docs/Web/HTTP/Content_negotiation négociation de contenu]
# par l'URL Special:EntityData, en suffixant l'extension correspondant au format souhaité (<code>.json</code>, <code>.rdf</code>, <code>.ttl</code> ou <code>.nt</code>) : <pre>https://data.biblissima.fr/w/Spécial:EntityData/Q{id}.ext</pre>
 
Exemple : https://data.biblissima.fr/w/Spécial:EntityData/Q2785.json
 
Lire plus d’informations sur https://www.wikidata.org/wiki/Wikidata:Data_access/fr#Interface_données_reliées
 
== Point d'accès SPARQL ==
 
''Ce point d'accès est actuellement en cours de test.''
 
== Service de réconciliation et d'alignement de données pour OpenRefine ==
 
Ce service web permet de brancher [https://openrefine.org/ OpenRefine] sur la plateforme data.biblissima.fr afin '''d'aligner vos données vers des entités Biblissima''' (cotes, personnes, organisations, lieux etc.).
 
* '''URL du service web de réconciliation : https://data.biblissima.fr/reconcile/fr/api'''
* URL du [https://reconciliation-api.github.io/specs/0.1/#service-manifest manifeste] du service web (pour OpenRefine) : https://raw.githubusercontent.com/OpenRefine/wikibase-manifests/master/biblissima-data-manifest.json
 
La réconciliation est le processus qui consiste à faire correspondre un jeu de données avec celui d'une source externe. Cela peut servir à harmoniser les différentes graphies d'un même nom (nom propre, libellé de descripteur, cote de manuscrit etc.), et de relier vos données à un jeu de données existant susceptible de fournir des informations supplémentaires sur une entité donnée (coordonnées géographiques, dates de naissance et de mort, références bibliographiques, liens et identifiants externes...).
 
Pour en savoir plus sur la réconciliation de données avec OpenRefine : https://docs.openrefine.org/manual/reconciling

Dernière version du 12 avril 2024 à 16:41

Autres langues :


La documentation des API est désormais disponible sur le site de documentation de Biblissima (rubrique API) : https://doc.biblissima.fr/api/

Pour obtenir des explications plus détaillées sur les API, vous pouvez aussi contacter l’équipe Biblissima+ à l’adresse team@biblissima-condorcet.fr