API:Filerepoinfo

MediaWiki版本：

≥ 1.22

获取请求以返回关于在wiki上配置的图像存储库的元信息。

API帮助文档

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 [在Api沙盒中尝试]

回应

{
    "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 MediaWiki 1.25中缺少参数。

参见

• API:Fileinfo - 在MediaWiki Action API的未来版本中取代这个prop 。
• 接口：Stashimageinfo - 检索有关存储映像的信息。
• API:Images - 检索页面上嵌入的所有图像。
• API:Info - 检索页列表的基本信息。
• API:Imageusage - 查找使用给定图像的所有页面。
• API:Imageinfo - 检索关于一个或多个映像文件的信息。