Aide de l’API MediaWiki

Ceci est une page d’aide de l’API de MediaWiki générée automatiquement.

Documentation et exemples : https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)

Ce module nécessite des droits de lecture.
Ce module nécessite des droits d’écriture.
Ce module accepte seulement les requêtes POST.
Source : MediaWiki
Licence : GPL-2.0-or-later

Téléverser un fichier, ou obtenir l’état des téléversements en cours.

Plusieurs méthodes sont disponibles :

téléverser directement le contenu du fichier, en utilisant le paramètre file ;
téléverser le fichier par morceaux, en utilisant les paramètres filesize, chunk, and offset ;
pour que le serveur MediaWiki récupère un fichier depuis une URL, utilisez le paramètre url ;
terminer un téléversement précédent qui a échoué à cause d’avertissements, en utilisant le paramètre filekey.

Noter l’envoi par la requête HTTP POST doit être effectué comme un téléversement de fichier (c’-à-d. en utilisant multipart/form-data) en envoyant le file.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Upload

Paramètres :

filename: Nom de fichier cible.
comment: Téléverser le commentaire. Utilisé aussi comme texte de la page initiale pour les nouveaux fichiers si text n’est pas spécifié.; Par défaut : (vide)
tags: Modifier les balises à appliquer à l’entrée du journal de téléversement et à la révision de la page du fichier.; Valeurs (séparées par | ou autre) :
text: Texte de page initiale pour les nouveaux fichiers.
watch: Obsolète.; Suivre la page.; Type : booléen (détails)
watchlist: Ajouter ou supprimer sans condition la page de votre liste de suivi, utiliser les préférences (ignorées pour les robots) ou ne pas modifier le suivi.; Une des valeurs suivantes : nochange, preferences, watch; Par défaut : preferences
ignorewarnings: Ignorer tous les avertissements.; Type : booléen (détails)
file: Contenu du fichier.; Doit être posté sous forme de téléversement de fichier utilisant multipart/form-data.
url: URL où chercher le fichier.
filekey: Clé identifiant un téléversement précédent temporairement mis en attente.
sessionkey: Obsolète.; Comme filekey, conservé pour des raisons de compatibilité descendante.
stash: Si positionné, le serveur conservera temporairement le fichier au lieu de l’ajouter au dépôt.; Type : booléen (détails)
filesize: Taille du téléversement entier.; Type: entier; La valeur doit être entre 0 et 104 857 600.
offset: Décalage du bloc en octets.; Type: entier; La valeur ne peut pas être inférieure à 0.
chunk: Partie du contenu.; Doit être posté sous forme de téléversement de fichier utilisant multipart/form-data.
async: Faire les grosses opérations de fichiers de façon asynchrone quand c’est possible.; Type : booléen (détails)
checkstatus: Récupérer uniquement l’état de téléversement pour la clé de fichier donnée.; Type : booléen (détails)
token: Un jeton « csrf » récupéré par action=query&meta=tokens; Ce paramètre est obligatoire.

Exemples :

Téléverser depuis une URL: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [ouvrir dans le bac à sable]
Terminer un téléversement qui a échoué à cause d’avertissements.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [ouvrir dans le bac à sable]