API:FicherArchiver/fr

Version de MediaWiki :

≥ 1.17

Requête GET pour énumérer tous les fichiers supprimés, séquentiellement dans la table filearchive .

Documentation de l'API

list=filearchive (fa)

(main | query | filearchive)

• This module requires read rights.
• Source: MediaWiki
• License: GPL-2.0-or-later

Enumerate all deleted files sequentially.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Filearchive

Specific parameters:

Other general parameters are available.

fafrom

The image title to start enumerating from.

fato

The image title to stop enumerating at.

faprefix

Search for all image titles that begin with this value.

fadir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

fasha1

SHA1 hash of image. Overrides fasha1base36.

fasha1base36

SHA1 hash of image in base 36 (used in MediaWiki).

faprop

Which image information to get:

sha1

Adds SHA-1 hash for the image.

timestamp

Adds timestamp for the uploaded version.

user

Adds user who uploaded the image version.

size

Adds the size of the image in bytes and the height, width and page count (if applicable).

dimensions

Alias for size.

description

Adds description of the image version.

parseddescription

Parse the description of the version.

mime

Adds MIME of the image.

mediatype

Adds the media type of the image.

metadata

Lists Exif metadata for the version of the image.

bitdepth

Adds the bit depth of the version.

archivename

Adds the filename of the archive version for non-latest versions.

Values (separate with | or alternative): archivename, bitdepth, description, dimensions, mediatype, metadata, mime, parseddescription, sha1, size, timestamp, user

Default: timestamp

falimit

How many images to return in total.

Type: integer or max

The value must be between 1 and 500.

Default: 10

facontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

Example:

Show a list of all deleted files.

api.php?action=query&list=filearchive [open in sandbox]

Exemple

Requête GET

Fournit une liste de tous les fichiers supprimés.

api.php?action=query&list=filearchive&format=json [Essayez !]

Réponse

{
    "batchcomplete": "",
    "continue": {
        "facontinue": "0000007.jpg|20070128133944|288",
        "continue": "-||"
    },
    "query": {
        "filearchive": [
            {
                "id": 1778,
                "name": "!notedit.png",
                "ns": 6,
                "title": "File:!notedit.png",
                "timestamp": "2011-04-25T13:17:47Z"
            },
            {
                "id": 6949,
                "name": "\"Twilight_at_the_pond\"_by_A.A.Tutunov_(1976).jpg",
                "ns": 6,
                "title": "File:\"Twilight at the pond\" by A.A.Tutunov (1976).jpg",
                "timestamp": "2019-01-26T11:48:52Z"
            },
            {
                "id": 5814,
                "name": "---C--temp-Regelwerk.pdf",
                "ns": 6,
                "title": "File:---C--temp-Regelwerk.pdf",
                "timestamp": "2017-03-09T10:09:24Z"
            },
            ...
        ]
    }
}

Exemple de code

Python

#!/usr/bin/python3

"""
    file_archive.py

    MediaWiki API Demos
    Demo of `Filearchive` module: Get a list of all deleted files.

    MIT License
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "action": "query",
    "list": "filearchive",
    "format": "json"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

print(DATA)

PHP

<?php
/*
    file_archive.php

    MediaWiki API Demos
    Demo of `Filearchive` module: Get a list of all deleted files.

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "query",
    "list" => "filearchive",
    "format" => "json"
];

$url = $endPoint . "?" . http_build_query( $params );

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );

$result = json_decode( $output, true );
var_dump( $result );

JavaScript

/*
    file_archive.js

    MediaWiki API Demos
    Demo of `Filearchive` module: Get a list of all deleted files.

    MIT License
*/

var url = "https://en.wikipedia.org/w/api.php"; 

var params = {
    action: "query",
    list: "filearchive",
    format: "json"
};

url = url + "?origin=*";
Object.keys(params).forEach(function(key){url += "&" + key + "=" + params[key];});

fetch(url)
    .then(function(response){return response.json();})
    .then(function(response) {console.log(response);})
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	file_archive.js

	MediaWiki API Demos
	Demo of `Filearchive` module: Get a list of all deleted files.

	MIT License
*/

var params = {
		action: 'query',
		list: 'filearchive',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	console.log( data );
} );

Erreurs possibles

Code	Info
cantview-deleted-description	Vous n’avez pas le droit d’afficher les descriptions des fichiers supprimés.
cantview-deleted-metadata	Vous n’avez pas le droit d’afficher les métadonnées des fichiers supprimés.
invalidsha1hash	Le hachage SHA1 fourni n’est pas valide.
invalidsha1base36hash	Le hachage SHA1Base36 fourni n’est pas valide.

Historique des paramètres

• v1.20: ajouté facontinue, mediatype, archivename
• v1.18: ajouté fato, fasha1, fasha1base36, parseddescription