Cette page fait partie de la documentation de l'API MediaWiki Action.

Si un site externe doit faire un appel à l'API d'un site MediaWiki, il doit utiliser CORS (de preférence) ou JSONP (plus ancien et moins sécurisé).

Utilisation de CORS

Si un script utilisateur ou un gadget est utilisé pour faire un appel à l'API vers un site qui appartient à la même famille de wikis , il doit utiliser un module MediaWiki qui fait appel à CORS sous l'accroche : mediawiki.ForeignApi . C'est ce principe qui est utilsé par exemple quand un script de la Wikipedia anglophone doit vérifier les informations d'une image de Commons. Le reste de cette section concerne les développeurs qui ne peuvent pas utiliser mediawiki.ForeignApi.

L'API MediaWiki demande que origin ou crossorigin soient fournis comme paramètre du texte de la requête. Si la requête CORS est authentifiée par le biais de cookies, la valeur de origin doit être le nom du site qui émet la requête, et qui est comparée avec l'entête Origin nécessaire au protocole CORS. Notez que ces paramètres doivent être inclus dans chaque requête de pré-vérification et doivent donc figurer dans la partie du texte de la requête, de l'URI adressée, même pour les requêtes de type POST.

Quand le paramètre origin est fourni et que la requête ne renvoie pas de réponse CORS positive, MediaWiki (depuis la 1.30) renvoie un entête MediaWiki-CORS-Rejection avec un bref motif d'échec, par exemple si l'origine ne correspond pas ou si un entête de la requête Access-Control-Request-Headers n'est pas supporté.

var apiEndpoint = "https://commons.wikimedia.org/w/api.php";
var params = "action=query&list=allimages&ailimit=3&format=json";

/**
 * envoyer la requête pour obtenir les images
 */
fetch(apiEndpoint + "?" + params + "&origin=*")
    .then(function(response){return response.json();})
    .then(function(response) {
          var allimages = response.query.allimages; // traiter la sortie pour obtenir le nom des images
          Object.keys(allimages).forEach(function(key) {
               console.log(allimages[key].name);
          });
     });

!!!!!_Mdina_Fortifications,_Ditch,_Bridge_and_Main_Gate.jpg
!!!!_Mdina_buildings_!!!!.jpg
!!!!_Palazzo_Dorell_ancillary_building.jpg

Utilisation de JSONP

L'API format=json accepte un paramètre callback dont la valeur est une fonction JavaScript dans laquelle la sortie JSON sera empaquetée. Ceci peut-être utilisé pour appeler l'API sur un site distant en ajoutant des balises ‎<script> dynamiquement au document.

var apiEndpoint = "https://en.wikipedia.org/w/api.php";
var params = "action=query&list=random&rnlimit=3&format=json";

/**
 * la fonction pour envelopper le résultat
 */
window.my_callback = function (response) {
    var pages = response.query.random; // traiter la sortie pour récupérer les titres
    Object.keys(pages).forEach(function(key) {
        console.log(pages[key].title);
    });
};

var scriptTag = document.createElement("script"); // créer dynamiquement une balise "script"
scriptTag.src = apiEndpoint + "?" + params + "&callback=my_callback"; // chaîne de la requête

document.body.appendChild(scriptTag); // ajouter la balise 'script' au document

Kache Aye Shoi
Talk:Sarbka, Wągrowiec County
Category:Nakhon Ratchasima Province

Voir aussi

• Extension:CentralAuth/API#centralauthtoken