واجهة برمجة التطبيقات:Pageprops

إصدار ميدياويكي:

≥ 1.17

طلب GET للحصول على عدة خصائص محددة في محتوى الصفحة.

توثيق واجهة برمجة التطبيقات

prop=pageprops (pp)

(main | query | pageprops)

• This module requires read rights.
• Source: MediaWiki
• License: GPL-2.0-or-later

Get various page properties defined in the page content.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Pageprops

Specific parameters:

Other general parameters are available.

ppcontinue

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

ppprop

Only list these page properties (action=query&list=pagepropnames returns page property names in use). Useful for checking whether pages use a certain page property.

Separate values with | or alternative.

Maximum number of values is 50 (500 for clients that are allowed higher limits).

Example:

Get properties for the pages MediaWiki and MediaWiki.

api.php?action=query&prop=pageprops&titles=MediaWiki|MediaWiki [open in sandbox]

مثال

طلب GET

الحصول على عدة خصائص محددة في محتوى الصفحة.

api.php?action=query&titles=Albert%20Einstein&prop=pageprops&format=json [جربها في ApiSandbox]

النتيجة

{
    "batchcomplete": "",
    "query": {
        "pages": {
            "736": {
                "pageid": 736,
                "ns": 0,
                "title": "Albert Einstein",
                "pageprops": {
                    "defaultsort": "Einstein, Albert",
                    "page_image_free": "Einstein_1921_by_F_Schmutzer_-_restoration.jpg",
                    "wikibase-badge-Q17437798": "1",
                    "wikibase_item": "Q937"
                }
            }
        }
    }

عينة من الكود البرمجي

Python

#!/usr/bin/python3

"""
    pageprops.py
    MediaWiki API Demos
    Demo of `Pageprops` module: Get various properties defined in the page content
    MIT License
"""

import requests

S = requests.Session()

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

PARAMS = {
    "action": "query",
    "titles": "Albert Einstein",
    "prop": "pageprops",
    "format": "json"
}

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

print(DATA)

PHP

<?php

/*
    pageprops.php
    MediaWiki API Demos
    Demo of `Pageprops` module: Get various properties defined in the page content
    MIT License
*/

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

/*
    pageprops.js
    MediaWiki API Demos
    Demo of `Pageprops` module: Get various properties defined in the page content
    MIT License
*/

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

var params = {
    action: "query",
    titles: "Albert Einstein",
    prop: "pageprops",
    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

/*
	pageprops.js
	MediaWiki API Demos
	Demo of `Pageprops` module: Get various properties defined in the page content
	MIT License
*/

var params = {
	action: 'query',
	titles: 'Albert Einstein',
	prop: 'pageprops',
	format: 'json'
};
var api = new mw.Api();

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

انظر أيضا

• واجهة برمجة التطبيقات:Pageswithprop – سرد قائمة بكل الصفحات التي تستخدم خاصية صفحة محددة.
• واجهة برمجة التطبيقات:Pagepropnames – سرد قائمة بكل أسماء خصائص الصفحة المستخدمة على موقع الويكي.
• API:properties – الحصول على خصائص عمومية للصفحات (ليست محددة بالضرورة في محتوى الصفحة).