Aide de l’API MediaWiki

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

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, qui était téléversé en partie ou enregistré autrement dans la zone de réserve des téléversements, 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 (en utilisant multipart/form-data) en envoyant le file ou chunk.

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

Paramètres spécifiques :

D'autres paramètres généraux sont disponibles.

filename: Nom du fichier cible. S'il n'est pas spécifié, et que file est utilisé, alors le nom de ce fichier sera utilisé.
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: Les balises de modification à 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 et autres détails. Vous devez fournir soit ça, ou filekey ou url.; Doit être posté sous forme de téléversement de fichier utilisant multipart/form-data.
url: URL où chercher le fichier. Vous devez fournir soit ça, ou file ou filekey.
filekey: Clé identifiant un téléversement précédent temporairement mis en attente. Vous devez fournir soit ça, soit file ou bien url.
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)
autotext: Générer le wikitext de la page de description du fichier côté serveur à partir des comment , license , copystatus et source, en remplaçant le paramètre text. Les extensions peuvent modifier le texte généré via l'accroche UploadForm:getInitialPageText. autotext existe et permet que action=upload corresponde au comportement de Special:Upload et du script de maintenance importImages.; Type : booléen (détails)
license: Licence sélectionnée pour le téléversement. C'est un nom de modèle. Utilisé uniquement avec autotext pour générer le wikicode de la page de description du fichier.; Par défaut : (vide)
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]