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.

Paramètres :
D'autres paramètres généraux sont disponibles.
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 10 485 760.
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.