API:Filerepoinfo

เวอร์ชันมีเดียวิกิ:

≥ 1.22

Get request that returns meta information about image repositories configured on the wiki.

API documentation

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 request

Get information about file repositories.

api.php?action=query&meta=filerepoinfo&friprop=url|name|displayname [ลองใช้ในกระบะทรายเอพีไอ]

Response

{
    "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 parameter is missing in 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 - finds all pages that use the given image or images.
• API:Imageinfo - retrieves information about an image file or files.