API:Filerepoinfo

Версия MediaWiki:

≥ 1.22

Get request that returns meta information about image repositories configured on the 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-запрос

Get information about file repositories.

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 отсутствует в MediaWiki 1.25.

Смотрите также

• API:Fileinfo - to supersede this prop in future versions of the MediaWiki Action API.
• API:Stashimageinfo - retrieves information about stashed images.
• API:Images - retrieves all images embedded on a page.
• API:Info - retrieves basic information about a list of pages.
• API:Imageusage - обнаруживает все страницы, которые используют данное изображение или изображения.
• API:Imageinfo - возвращает информацию о файле или файлах изображений.