« Project:API » : différence entre les versions
Aucun résumé des modifications |
(Cette version a été marquée à traduire) |
||
Ligne 4 : | Ligne 4 : | ||
<!--T:1--> | |||
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 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). | ||
<!--T:2--> | |||
{{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, vous pouvez contacter l’équipe Biblissima à l’adresse [mailto:team@biblissima-condorcet.fr team@biblissima-condorcet.fr]}} | ||
== API Mediawiki/Wikibase == | == API Mediawiki/Wikibase == <!--T:3--> | ||
<!--T:4--> | |||
La plateforme data.biblissima.fr dispose des mêmes accès par API que Wikidata ou les autres instances de Mediawiki/Wikibase : | La plateforme data.biblissima.fr dispose des mêmes accès par API que Wikidata ou les autres instances de Mediawiki/Wikibase : | ||
<!--T:5--> | |||
* '''URL du point d'accès et de la documentation de l'API : https://data.biblissima.fr/w/api.php''' | * '''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 | * '''Bac à sable''' pour expérimenter l’API (interrogation guidée au moyen d’un formulaire) : https://data.biblissima.fr/w/Spécial:ApiSandbox | ||
<!--T:6--> | |||
Lire la documentation officielle : | Lire la documentation officielle : | ||
* [https://www.mediawiki.org/wiki/API:Main_page/fr API action de MediaWiki] | * [https://www.mediawiki.org/wiki/API:Main_page/fr API action de MediaWiki] | ||
* [https://www.mediawiki.org/wiki/Wikibase/API/fr API Wikibase] | * [https://www.mediawiki.org/wiki/Wikibase/API/fr API Wikibase] | ||
== Interface de données liées (RDF) == | == Interface de données liées (RDF) == <!--T:7--> | ||
<!--T:8--> | |||
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> | 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> | ||
<!--T:9--> | |||
Exemple : https://data.biblissima.fr/entity/Q2785 | Exemple : https://data.biblissima.fr/entity/Q2785 | ||
<!--T:10--> | |||
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. | 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. | ||
<!--T:11--> | |||
Elles sont accessibles de deux façons : | 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 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> | # 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> | ||
<!--T:12--> | |||
Exemple : https://data.biblissima.fr/w/Spécial:EntityData/Q2785.json | Exemple : https://data.biblissima.fr/w/Spécial:EntityData/Q2785.json | ||
<!--T:13--> | |||
Lire plus d’informations sur https://www.wikidata.org/wiki/Wikidata:Data_access/fr#Interface_données_reliées | Lire plus d’informations sur https://www.wikidata.org/wiki/Wikidata:Data_access/fr#Interface_données_reliées | ||
== Point d'accès SPARQL == | == Point d'accès SPARQL == <!--T:14--> | ||
<!--T:15--> | |||
''Ce point d'accès est actuellement en cours de test.'' | ''Ce point d'accès est actuellement en cours de test.'' | ||
== Service de réconciliation et d'alignement de données pour OpenRefine == | == Service de réconciliation et d'alignement de données pour OpenRefine == <!--T:16--> | ||
<!--T:17--> | |||
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.). | 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.). | ||
<!--T:18--> | |||
* '''URL du service web de réconciliation : https://data.biblissima.fr/api/reconcile''' | * '''URL du service web de réconciliation : https://data.biblissima.fr/api/reconcile''' | ||
<!--T:19--> | |||
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...). | 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...). | ||
<!--T:20--> | |||
Pour en savoir plus sur la réconciliation de données avec OpenRefine : https://docs.openrefine.org/manual/reconciling | Pour en savoir plus sur la réconciliation de données avec OpenRefine : https://docs.openrefine.org/manual/reconciling | ||
</translate> | </translate> |
Version du 4 février 2021 à 09:46
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).
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 :
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 :
https://data.biblissima.fr/entity/Q{id}
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 négociation de contenu
- par l'URL Special:EntityData, en suffixant l'extension correspondant au format souhaité (
.json
,.rdf
,.ttl
ou.nt
) :https://data.biblissima.fr/w/Spécial:EntityData/Q{id}.ext
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 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/api/reconcile
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