API:REST API/fr

L'API REST du noyau de MediaWiki vous pertmet d'interagir avec MediaWiki en envoyant des requêtes HTTP vers des URLs uniques. Vous pouvez utiliser l'API pour construire des applications et des scripts qui exécutent des recherches et affichent des pages wiki, récupèrent des fichiers de médias, et exploitent l'historique des pages.

Démarrage rapide
$ curl

Formats des données
Les points d'accès de l'API REST renvoient les données au format JSON ou HTML. Voir les références de l'API pour le type de contenu pris en charge par chaque point d'accès.

Méthodes
L'API prend en charge les méthodes des requêtes HTTP usuelles.

Structure des URLs
Les points d'accès de l'API partagent une structure cohérente d'URL qui inclut l'URL de base du wiki, le chemin du script du wiki, et la version de l'API.

Versions
Designed to provide long-term stability for developers, the MediaWiki REST API is versioned using a global version number in the API path (for example: ). D'après les principes de la sémantique des versions, cette dernière est incrémentée lorsqu'un point d'accès est modifié et qu'il ne soit plus possible de revenir en arrière, comme par exemple lors de la suppression d'une propriété de réponse ou de l'ajout d'un paramètre obligatoire. Avec une version majeure, l'API peut être modifiée de sorte à pouvoir revenir en arrière, comme par exemple ajouter une propriété de réponse ou un paramètre de requête optionnel.

Droits et autorisations
L'API REST est conçue pour être utilisée avec l'extension pour l'authentification des utilisateurs et les permissions. However, regardless of the authentication method, the API responds to the presence of a logged-in user and returns content appropriate to that user's permissions.

Accès aux projets Wikimedia avec l'API REST
You can use the REST API to access Wikipedia, Wiktionary, and other Wikimedia projects in multiple languages. Pour une liste complète des URLs des projets Wikimedia, voir la matrice des sites Meta-Wiki.

Limitation des requêtes
Il n'existe aucune limite fixée quant aux requêtes de l'API, mais votre client peut être bloqué si vous attentez à la stabilité d'un site. Pour rester à un niveau sécuritaire de requête, attendez que chaque requête se termine avant d'envoyer la requête suivante.

Identification des clients
Les sites Wikimedia nécessitent un entête d'agent utilisateur HTTP pour chaque requête d'API. This helps identify your app and ensures that system administrators can contact you if a problem arises. Clients making requests without a User-Agent header may be IP-blocked without notice.

The User-Agent header can include a user page on the local wiki, a user page on a related wiki using interwiki linking syntax, a URL for a relevant external website, or an email address.

If you are calling the API from browser-based JavaScript, you may not be able to influence the User-Agent header, depending on the browser. Pour contourner cela, utilisez l'entête. Voir la politique des agents utilisateur de Meta-Wiki pour plus d'information.

Autorisation
To authorize your app to act on behalf of a user, follow the OAuth developer guide to register your app and make requests using OAuth tokens.

Licences et marques commerciales
Wikimedia content is free to reuse within the terms specified by the applicable license. Licenses can differ between projects, so see the individual project for information about licenses and content reuse. For example, English Wikipedia’s text can be used under the terms of the Creative Commons Attribution Share-Alike license, while media files on Wikimedia Commons are licensed individually as indicated on the file’s information page. For more information about licensing and trademark use, see Meta-Wiki’s developer app guidelines.

Limites de Wikidata
While the REST API is available on Wikimedia projects, it is not fully supported by Wikidata. Au moment où nous écrivons ces lignes, certains des points d'accès peuvent renvoyer des erreurs inattendues.

Point d'accès des extensions
MediaWiki extensions can surface extension-specific API endpoints using the REST API interface. See the REST API extension interface docs to get started. For documentation for REST API endpoints provided by extensions, see the extension docs. The REST API extension interface is available in via  and in  and later by default.

À propos de ces documents
Ces documents ont été écrits manuellement en se basant sur le. Les corrections et les ajouts restent les bienvenus ! To share a tutorial or app that uses the MediaWiki REST API, add a link to the REST API template.