واجهة برمجة التطبيقات:Filearchive
Appearance
From mediawiki.org
This page is a translated version of the page API:Filearchive and the translation is 100% complete.
Languages:
هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action.
| واجهة برمجة التطبيقات لتطبيق Action على ميدياويكي |
|---|
| الأساسيات |
| التصديق |
| الحسابات والمستخدمين |
| عمليات الصفحات |
| البحث |
| أدوات المطورين |
| برامج تعليمية |
| ع · ن · ت |
إصدار ميدياويكي:
≥ 1.17
طلب GET الغرض منه عد كافة الملفات المحذوفة من جدول filearchive تتابعيًا.
توثيق واجهة برمجة التطبيقات
أعمال التوثيق التالية هي نتاج صفحة Special: ApiHelp/ query+filearchive، التي ولّدتها آليا نسخة سابقة للإصدار من برمجيات ميدياويكي تعمل على هذا الموقع الشبكي (MediaWiki.org).
list=filearchive (fa)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Enumerate all deleted files sequentially.
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
الحصول على قائمة بكافة الملفات المحذوفة.
النتيجة
{ "batchcomplete":"", "continue":{ "facontinue":"0000007.jpg|20070128133944|288", "continue":"-||" }, "query":{ "filearchive":[ { "id":1778, "name":"!notedit.png", "ns":6, "title":"File:!notedit.png", "timestamp":"2011年04月25日T13: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月26日T11:48:52Z" }, { "id":5814, "name":"---C--temp-Regelwerk.pdf", "ns":6, "title":"File:---C--temp-Regelwerk.pdf", "timestamp":"2017年03月09日T10: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 """ importrequests 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 */ varurl="https://en.wikipedia.org/w/api.php"; varparams={ action:"query", list:"filearchive", format:"json" }; url=url+"?origin=*"; Object.keys(params).forEach(function(key){url+="&"+key+"="+params[key];}); fetch(url) .then(function(response){returnresponse.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 */ varparams={ action:'query', list:'filearchive', format:'json' }, api=newmw.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