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
- 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-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 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 exemple en utilisant multipart/form-data
) en envoyant le file.
- 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 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)
- token
Un jeton « csrf » récupéré par action=query&meta=tokens
- Ce paramètre est obligatoire.
- 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]