واجهة برمجة التطبيقات:Filearchive

إصدار ميدياويكي:

≥ 1.17

طلب GET الغرض منه عد كافة الملفات المحذوفة من جدول filearchive تتابعيًا.

توثيق واجهة برمجة التطبيقات

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]

مثال

طلب GET

الحصول على قائمة بكافة الملفات المحذوفة.

api.php?action=query&list=filearchive&format=json [جربها في ApiSandbox]

النتيجة

{
    "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"
            },
            ...
        ]
    }
}

عينة من الكود البرمجي

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 );
} );

الأخطاء المحتملة

الكود	معلومات
cantview-deleted-description	ليس لديك صلاحية لعرض أوصاف الملفات المحذوفة.
cantview-deleted-metadata	ليس لديك صلاحية لعرض البيانات الوصفية للملفات المحذوفة.
invalidsha1hash	رمز رقم SHA1 المقدم غير صالح.
invalidsha1base36hash	رمز رقم SHA1Base36 المقدم غير صالح.

تاريخ المتغيرات

• v1.20: إضافة facontinue, mediatype, archivename
• v1.18: إضافة fato, fasha1, fasha1base36, parseddescription