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
- 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
.
- 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 104 857 600.
- 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.
- 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