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

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

≥ 1.22

طلب GET يرد معلومات فوقية عن مستودعات الصور المضبوطة على موقع الويكي.

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

meta=filerepoinfo (fri)

(main | query | filerepoinfo)

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

Return meta information about image repositories configured on the wiki.

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

Specific parameter:

Other general parameters are available.

friprop

Which repository properties to get (properties available may vary on other wikis).

canUpload

Whether files can be uploaded to this repository, e.g. via CORS and shared authentication.

descBaseUrl

(no description)

descriptionCacheExpiry

(no description)

displayname

The human-readable name of the repository wiki.

favicon

Repository wiki's favicon URL, from $wgFavicon.

fetchDescription

Whether file description pages are fetched from this repository when viewing local file description pages.

initialCapital

Whether file names implicitly start with a capital letter.

local

Whether that repository is the local one or not.

name

The key of the repository - used in e.g. $wgForeignFileRepos and imageinfo return values.

rootUrl

Root URL path for image paths.

scriptDirUrl

Root URL path for the repository wiki's MediaWiki installation.

thumbUrl

Root URL path for thumbnail paths.

url

Public zone URL path.

Values (separate with | or alternative): canUpload, descBaseUrl, descriptionCacheExpiry, displayname, favicon, fetchDescription, initialCapital, local, name, rootUrl, scriptDirUrl, thumbUrl, url

Default: canUpload|descBaseUrl|descriptionCacheExpiry|displayname|favicon|fetchDescription|initialCapital|local|name|rootUrl|scriptDirUrl|thumbUrl|url

Example:

Get information about file repositories.

api.php?action=query&meta=filerepoinfo&friprop=name|displayname [open in sandbox]

مثال

طلب GET

الحصول على معلومات عن مستودعات ملفات.

api.php?action=query&meta=filerepoinfo&friprop=url|name|displayname [جربها في ApiSandbox]

النتيجة

{
    "batchcomplete": "",
    "query": {
        "repos": [
            {
                "name": "shared",
                "displayname": "Commons",
                "url": "//upload.wikimedia.org/wikipedia/commons"
            },
            {
                "name": "local",
                "displayname": "Wikipedia",
                "url": "//upload.wikimedia.org/wikipedia/en"
            }
        ]
    }
}

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

Python

#!/usr/bin/python3

"""
    file_repo_info.py

    MediaWiki API Demos
    Demo of `Filerepoinfo` module: Get information about file repositories.

    MIT License
"""

import requests

S = requests.Session()

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

PARAMS = {
    "action": "query",
    "meta": "filerepoinfo",
    "format": "json",
    "friprop": "url|name|displayname"
}

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

print(DATA)

PHP

<?php

/*
    file_repo_info.php

    MediaWiki API Demos
    Demo of `Filerepoinfo` module: Get information about file repositories.

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "query",
    "meta" => "filerepoinfo",
    "format" => "json",
    "friprop" => "url|name|displayname"
];

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

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

echo( $output );

JavaScript

/*
	file_repo_info.js

    MediaWiki API Demos
    Demo of `Filerepoinfo` module: Get information about file repositories.

    MIT License
*/

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

var params = {
    action: "query",
    meta: "filerepoinfo",
    format: "json",
    friprop: "url|name|displayname"
};
request.get({ url: url, qs: params }, function(error, res, body) {
    if (error) {
        return;
    }
    console.log(body);
});

MediaWiki JS

/*
	file_repo_info.js

    MediaWiki API Demos
    Demo of `Filerepoinfo` module: Get information about file repositories.

    MIT License
*/

var params = {
    action: "query",
    meta: "filerepoinfo",
    format: "json",
    friprop: "url|name|displayname"
},
api = new mw.Api();

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

ملاحظات إضافية

• متغير apiurl غير موجود في برمجيات ميدياويكي 1.25.

انظر أيضا

• API:Fileinfo - يحل محل prop في الإصدارات القادمة من واجهة برمجة التطبيقات لتطبيق Action على ميدياويكي.
• API:Stashimageinfo - جلب معلومات عن صور stashed.
• واجهة برمجة التطبيقات:صور - جلب معلومات عن كافة الصور المدمجة في صفحة محددة.
• واجهة برمجة التطبيقات:معلومات - جلب معلومات أساسية عن قائمة بالصفحات.
• واجهة برمجة التطبيقات:Imageusage - البحث عن كافة الصفحات التي تستخدم الصورة المحددة أو الصور المعينة.
• واجهة برمجة التطبيقات:معلومات_صورة - جلب معلومات عن ملف صورة أو ملفات صور.