API:Fileusage

From mediawiki.org
This page is a translated version of the page API:Fileusage and the translation is 100% complete.
MediaWiki sürümü:
1.24

Verilen dosyaları kullanan tüm sayfaları bulmak için GET isteği.

API belgesi


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.

Örnek

GET isteği

Belirli bir dosyayı kullanarak sayfaların listesini alın.


Yanıt

{
    "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"
                    },
                    ...
                ]
            }
        }
    }
}

Örnek kod

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 );
} );

Olası hatalar

Kod Bilgi
fushow Incorrect parameter - mutually exclusive values may not be supplied.

Ek notlar

Ayrıca bakınız

  • API:Allfileusages - Mevcut olmayanlar da dahil olmak üzere tüm dosya kullanımlarını listeleyin.