Aide de l’API de MediaWiki

Ceci est une page d’aide de l’API de MédiaWiki 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.

Télécharger un fichier, ou obtenir l’état des téléchargements en cours.

Plusieurs méthodes sont disponibles :

  • Télécharger directement le contenu du fichier, en utilisant le paramètre file.
  • Télécharger le fichier par morceaux, en utilsiant les paramètres filesize, chunk, and offset.* Pour que le serveur MédiaWiki cherche un fichier depuis une URL, utiliser le paramètre url.
  • Terminer un téléchargement 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échargement de fichier (par ex. en utilisant multipart/form-data) en envoyant le multipart/form-data.

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.

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 valeur : watch, preferences, nochange
Par défaut : preferences
ignorewarnings

Ignorer tous les avertissements.

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.

filesize

Taille du fichier de tout le téléchargement.

La valeur doit être entre 0 et 104 857 600.
offset

Décalage du bloc en octets.

La valeur doit être inférieure à 0.
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.

asyncdownload

Faire de façon asynchrone la recherche d’une URL.

leavemessage

Si asyncdownload est utilisé, laisser un message sur la page de discussion de l’utilisateur quand c’est terminé.

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.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.