Aide de l’API de 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/API

action=upload

(main | upload)

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

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 MédiaWiki cherche 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 que le POST HTTP doit être fait comme un téléversement de fichier (par ex. en utilisant multipart/form-data) en envoyant le multipart/form-data.

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

Paramètres :

filename: Nom de fichier cible.
comment: Télécharger 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)
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 la liste de suivi de l’utilisateur actuel, utiliser les préférences ou ne pas changer le suivi.; Une des valeurs suivantes : watch, preferences, nochange; Par défaut : preferences
ignorewarnings: Ignorer tous les avertissements.; Type : booléen (détails)
file: Contenu du fichier.; Doit être envoyé comme un fichier importé utilisant multipart/form-data.
url: URL où chercher le fichier.
filekey: Clé identifiant un téléchargement 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 fichier de tout le téléchargement.; La valeur doit être entre 0 et 536 870 912.; Type : entier
offset: Décalage du bloc en octets.; La valeur doit être inférieure à 0.; Type : entier
chunk: Partie du contenu.; Doit être envoyé comme un fichier importé utilisant multipart/form-data.
async: Faire de façon asynchrone les grosses opérations sur les fichiers quand c’est possible.; Type : booléen (détails)
asyncdownload: Faire de façon asynchrone la recherche d’une URL.; Type : booléen (détails)
leavemessage: Si asyncdownload est utilisé, laisser un message sur la page de discussion de l’utilisateur quand c’est terminé.; Type : booléen (détails)
statuskey: Récupérer l’état de téléchargement pour cette clé de fichier (téléchargé par URL).
checkstatus: Récupérer uniquement l’état de téléchargement 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écharger depuis une URL: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC
Terminer un téléchargement qui a échoué à cause d’avertissements: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC