Jump to content

API:Použití souboru

From mediawiki.org
This page is a translated version of the page API:Fileusage and the translation is 94% complete.
Verze MediaWiki:
1.24

Požadavek GET pro nalezení všech stránek, které používají dané soubory.

Dokumentace API

prop=fileusage (fu)

(main | query | fileusage)
  • This module requires read rights.
  • This module can be used as a generator.
  • Source: MediaWiki
  • License: GPL-2.0-or-later

Find all pages that use the given files.

Specific parameters:
Other general parameters are available.
fuprop

Which properties to get:

pageid
Page ID of each page.
title
Title of each page.
redirect
Flag if the page is a redirect.
Values (separate with | or alternative): pageid, redirect, title
Default: pageid|title|redirect
funamespace

Only include pages in these namespaces.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 90, 91, 92, 93, 100, 101, 102, 103, 104, 105, 106, 107, 486, 487, 710, 711, 828, 829, 1198, 1199, 2600, 5500, 5501
To specify all values, use *.
fushow

Show only items that meet these criteria:

redirect
Only show redirects.
!redirect
Only show non-redirects.
Values (separate with | or alternative): !redirect, redirect
fulimit

How many to return.

Type: integer or max
The value must be between 1 and 500.
Default: 10
fucontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.


Příklad

Dotazování přes GET

Získejte seznam stránek pomocí daného souboru.

Odpověď

{
    "continue": {
        "fucontinue": "4635245",
        "continue": "||"
    },
    "query": {
        "pages": {
            "586539": {
                "pageid": 586539,
                "ns": 6,
                "title": "File:Example.jpg",
                "fileusage": [
                    {
                        "pageid": 447341,
                        "ns": 5,
                        "title": "Wikipedia talk:Extended image syntax"
                    },
                    {
                        "pageid": 499974,
                        "ns": 4,
                        "title": "Wikipedia:Tutorial/Formatting"
                    },
                    {
                        "pageid": 554270,
                        "ns": 13,
                        "title": "Help talk:Pictures"
                    },
                    ...
                ]
            }
        }
    }
}

Ukázkový kód

Python

#!/usr/bin/python3

"""
    get_file_usage.py

    MediaWiki API Demos
    Demo of `Fileusage` module: Get a list of pages using a given file.

    MIT License
"""

import requests

S = requests.Session()

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

PARAMS = {
    "action": "query",
    "titles": "File:Example.jpg",
    "prop": "fileusage",
    "format": "json"
}

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

print(DATA)

PHP

<?php
/*
    get_file_usage.php

    MediaWiki API Demos
    Demo of `Fileusage` module: Get a list of pages using a given file.

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "query",
    "titles" => "File:Example.jpg",
    "prop" => "fileusage",
    "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

/*
    get_file_usage.js

    MediaWiki API Demos
    Demo of `Fileusage` module: Get a list of pages using a given file.

    MIT License
*/

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

var params = {
    action: "query",
    titles: "File:Example.jpg",
    prop: "fileusage",
    format: "json"
};

url = url + "?origin=*";
Object.keys(params).forEach(function(key){url += "&" + key + "=" + params[key];});

fetch(url)
    .then(function(response){return response.json();})
    .then(function(response) {console.log(response);})
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	get_file_usage.js

	MediaWiki API Demos
	Demo of `Fileusage` module: Get a list of pages using a given file.

	MIT License
*/

var params = {
		action: 'query',
		titles: 'File:Example.jpg',
		prop: 'fileusage',
		format: 'json'
	},
	api = new mw.Api();

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

Možné chyby

Kód Popis
fushow Incorrect parameter - mutually exclusive values may not be supplied.

Další poznámky

  • Tento modul lze použít jako zdroj.

Související odkazy

  • API:Globalusage - List all file usages on wikis other than the one where the file is stored.
  • API:Allfileusages - Uveďte všechna použití souborů, včetně těch, které neexistují.