Skip to content
This repository has been archived by the owner on Feb 4, 2021. It is now read-only.

Proof of Concept: [FFU] Upload files by script

Jump to bottom
wikipedia-mabdul edited this page Nov 10, 2013 · 3 revisions

In December I (User:mabdul) plan to add an automatic upload of a file using the AFCH gadget for reviewing WP:FFU. Feel free to give me more ressource, but @Theopolisme: let that goody my toy and don't do it. XD

Ressource:

* action=upload *
  Upload a file, or get the status of pending uploads. Several methods are available:
   * Upload file contents directly, using the "file" parameter
   * Have the MediaWiki server fetch a file from a URL, using the "url" parameter
   * Complete an earlier upload that failed due to warnings, using the "filekey" parameter
  Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data) when
  sending the "file". Also you must get and send an edit token before doing any upload stuff
  https://www.mediawiki.org/wiki/API:Upload

This module requires read rights
This module requires write rights
This module only accepts POST requests
Parameters:
  filename            - Target filename
  comment             - Upload comment. Also used as the initial page text for new files if "text" is not specified
                        Default: 
  text                - Initial page text for new files
  token               - Edit token. You can get one of these through prop=info
                        This parameter is required
  watch               - DEPRECATED! Watch the page
  watchlist           - Unconditionally add or remove the page from your watchlist, use preferences or do not change watch
                        One value: watch, preferences, nochange
                        Default: preferences
  ignorewarnings      - Ignore any warnings
  file                - File contents
                        Must be posted as a file upload using multipart/form-data
  url                 - URL to fetch the file from
  filekey             - Key that identifies a previous upload that was stashed temporarily.
  sessionkey          - DEPRECATED! Same as filekey, maintained for backward compatibility.
  stash               - If set, the server will not add the file to the repository and stash it temporarily.
  filesize            - Filesize of entire upload
  offset              - Offset of chunk in bytes
  chunk               - Chunk contents
                        Must be posted as a file upload using multipart/form-data
  async               - Make potentially large file operations asynchronous when possible
  asyncdownload       - Make fetching a URL asynchronous
  leavemessage        - If asyncdownload is used, leave a message on the user talk page if finished
  statuskey           - Fetch the upload status for this file key (upload by URL)
  checkstatus         - Only fetch the upload status for the given file key
Examples:
  Upload from a URL:
    api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png
  Complete an upload that failed due to warnings:
    api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1

TODO-List

  • find out if upload by URL is activated at enwp and at commons **if not, find out how to download and store image local for the upload session
Clone this wiki locally