Wikibase/API/fr



Qu'est-ce que l'API Wikibase ?
Wikibase fournit un mécanisme général pour sauvegarder les déclarations dans des données structurées. Les déclarations concernant les éléments se trouvent sur le serveur wikidata.org. Voir wikidata:Glossary pour plus d'explications sur Wikibase et les autres concepts.



L'API Wikibase permet d'interroger, d'ajouter, de supprimer et de modifier les informations de Wikidata ou de tout autre instance de Wikibase.

Il est fourni via un ensemble d'extensions aux modules API de MediaWiki. Donc, pour utiliser l'API Wikibase, vous devez avoir les connaissances de base concernant l'API MediaWiki Action : actions, requêtes, etc., ainsi que les paramètres génériques tels que  et.



Comment utiliser l'API Wikibase
Envoyer les requêtes à l'API avec le protocole HTTP, comme pour l'API Action de MediaWiki. Voir le tutoriel Comment utiliser l'API pour toute information concernant l'utilisation de l'API Action de MediaWiki.



Format de la requête
Le point d'accès de l'API est https://wikidata.org/w/api.php.

Dans la chaîne de la requête, ajoutez le paramètre action qui indique à l'API l'action à réaliser. Par exemple  indique à l'API de récupérer les données pour les entités Wikibase. Pour les sous-modules de meta et des propriétés, utiliser respectivement  et.

Certains paramètres sont presque toujours disponibles. Les formes plurielles sont utilisées dans les cas où un paramètre peut prendre plusieurs valeurs. Les paramètres sont :



Une requête simple


Requête GET
Détail de chaque partie de l'URL :


 * est le point d'accès principal.
 * indique à l'API de récupérer les données pour les entités Wikibase.
 * indique qu'il faut obtenir les données de la Wikipedia anglophone.
 * indique le titre de la page pour laquelle on souhaite obtenir les données.
 * indique les propriétés à récupérer des entités, dans ce cas la propriété est la description des entités.
 * signifie qu'il faut filtrer les résultats en anglais par ordre décroissant.
 * indique le format de sortie JSON, qui est le format de sortie recommandé.

Réponse
La réponse à une requête contient généralement :


 * Une clé  avec une conversion booléenne sous forme d'entier si la demande aboutit. Si l'entier est zéro, toute valeur supplémentaire peut être erronée.
 * Une clé  avec un objet formé de deux, éventuellement trois clés, ,   et  , si la demande échoue.
 * Informations sur l'action. Les informations sont soit transmises au niveau supérieur, soit sous « élément » s'il s'agit d'un seul élément ou « éléments » s'il y en a plusieurs. S'il s'agit de plusieurs éléments, chacun se trouve sous une clé avec son propre identifiant d'élément.

Les objets vides sont renvoyés en tant que tableaux JSON et non en tant qu'objets, tandis que les paramètres vides « suppriment » l'entrée réelle de l'élément.



Documentation de l'API et modules de Wikibase


Sous-modules de Meta

 * wikibase:
 * wbcontentlanguages:



Sous-modules des propriétés

 * pageterms:
 * wbentityusage:



Modules de l'API

 * wbgetentities:
 * wbavailablebadges:
 * wbcreateclaim:
 * wbcreateredirect:
 * wbeditentity:
 * wbformatvalue:
 * wbgetclaims:
 * wblinktitles:
 * wbmergeitems:
 * wbparsevalue:
 * wbremoveclaims:
 * wbremovequalifiers:
 * wbremovereferences:
 * wbsearchentities:
 * wbsetaliases:
 * wbsetclaim:
 * wbsetclaimvalue:
 * wbsetdescription:
 * wbsetlabel:
 * wbsetqualifier:
 * wbsetreference:
 * wbsetsitelink:
 * wbsgetsuggestions:
 * wbcheckconstraints:
 * wbcheckconstraintparameters:



Erreurs possibles
Les erreurs possibles pour n'importe quel module peuvent être trouvées en utilisant. Le format de l'erreur est celui de l'API Action de MediaWiki. Voir l'Ancien format des erreurs et avertissements de l'API.

Tous les messages d'erreur des modules Wikibase doivent être internationalisés (i18n) et localisés (l10n). La langue de l'utilisateur connecté sera la langue par défaut des messages d'erreur, mais vous pouvez la remplacer en ajoutant dans l'URL  à la chaîne de la requête.



Notes supplémentaires

 * De nombreux wikis Wikimedia exécutent l' extension Wikibase Client. Cela permet à leurs clients API d'interroger le sous-module Méta  pour déterminer les URLs du dépôt Wikibase complet, et au sous-module des propriétés   d'obtenir des informations Wikidata sur les pages du wiki local.
 * Les modèles de calendriers pouvant être utilisés dans Wikibase sont le calendrier grégorien (Q1985727) et le calendrier Julien (Q1985786).
 * L'API utilise les IDs des révisions pour détecter les collisions dans les modifications. Dans le cas d'une telle collision, le demandeur doit acquérir un ID de révision plus récent pour pouvoir continuer. Typiquement cela consiste à interroger  pour l'élément en question, puis de ranger (et utiliser) la révision à partir de la saisie.
 * Toute installation MediaWiki peut exécuter Wikibase. Sur le cluster Wikimedia, la plupart des wikis n'utilisent pas l'ensemble complet d'extensions Wikibase. Wikimedia Commons possède sa propre Wikibase pour les propriétés des fichiers sur Commons.
 * Ne testez pas la valeur  pour une erreur donnée, mais utilisez la valeur   à la place car celle-ci est indépendante de la localisation.



Voir aussi

 * - Le guide de démarrage rapide pour l'API Action de MediaWiki.
 * - Questions fréquentes à propos de l'API Action MediaWiki.
 * - Un tutoriel sur comment utiliser l'API Action de MediaWiki.
 * Télécharger les Vidages de la base de données Wikidata au format JSON (recommandé), XML et RDF.