Jump to content
MediaWiki

واجهة برمجة التطبيقات:معلومات_المتغيرات

From mediawiki.org
This page is a translated version of the page API:Parameter information and the translation is 100% complete.
واجهة برمجة التطبيقات لتطبيق Action على ميدياويكي
الأساسيات
التصديق
الحسابات والمستخدمين
عمليات الصفحات
البحث
أدوات المطورين
برامج تعليمية
ع · ن · ت
إصدار ميدياويكي:
≥ 1.12

طلب GET للحصول على معلومات عن وحدات واجهة برمجة التطبيقات البرمجية التي تحمل اسم Action الأخرى، وكذلك متغيراتها.

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

أعمال التوثيق التالية هي نتاج صفحة Special:ApiHelp/paraminfo، التي ولّدتها آليا نسخة سابقة للإصدار من برمجيات ميدياويكي تعمل على هذا الموقع الشبكي (MediaWiki.org).

action=paraminfo

(main | paraminfo)

Obtain information about API modules.

Specific parameters:
Other general parameters are available.
modules

List of module names (values of the action and format parameters, or main). Can specify submodules with a +, or all submodules with +*, or all submodules recursively with +**.

Separate values with | or alternative.
Maximum number of values is 50 (500 for clients that are allowed higher limits).
helpformat

Format of help strings.

One of the following values: html, none, raw, wikitext
Default: none
querymodules
Deprecated.

List of query module names (value of prop, meta or list parameter). Use modules=query+foo instead of querymodules=foo.

Values (separate with | or alternative): abusefilters, abuselog, allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allmessages, allpages, allredirects, allrevisions, alltransclusions, allusers, authmanagerinfo, babel, backlinks, betafeatures, blocks, categories, categoryinfo, categorymembers, centralnoticeactivecampaigns, centralnoticelogs, checkuser, checkuserformattedblockinfo, checkuserlog, cirrusbuilddoc, cirruscompsuggestbuilddoc, cirrusdoc, codexicons, communityconfiguration, communityrequests-wishes, contributors, deletedrevisions, deletedrevs, description, duplicatefiles, embeddedin, extdistbranches, extdistrepos, extlinks, extracts, exturlusage, featureusage, filearchive, filerepoinfo, fileusage, flowinfo, gadgetcategories, gadgets, globalallusers, globalblocks, globalgroups, globalpreferences, globalrenamequeue, globalrenamestatus, globalusage, globaluserinfo, globalusers, imageinfo, images, imageusage, info, iwbacklinks, iwlinks, langbacklinks, langlinks, languageinfo, languagestats, links, linkshere, linterrors, linterstats, logevents, managemessagegroups, mapdata, messagecollection, messagegroups, messagegroupstats, messagegroupsubscription, messagetranslations, mmcontent, mostviewed, mystashedfiles, notifications, pagecollectionsmetadata, pageimages, pagepropnames, pageprops, pageswithprop, pageterms, pageviews, prefixsearch, protectedtitles, querypage, random, readinglistentries, readinglists, recentchanges, redirects, revisions, search, siteinfo, siteviews, stashimageinfo, tags, templates, threads, tokens, trackingcategories, transcludedin, transcodestatus, unreadnotificationpages, usercontribs, userinfo, users, videoinfo, watchlist, watchlistraw, wbentityusage, wblistentityusage, wikibase, wikisets
Maximum number of values is 50 (500 for clients that are allowed higher limits).
mainmodule
Deprecated.

Get information about the main (top-level) module as well. Use modules=main instead.

pagesetmodule
Deprecated.

Get information about the pageset module (providing titles= and friends) as well.

formatmodules
Deprecated.

List of format module names (value of format parameter). Use modules instead.

Values (separate with | or alternative): json, jsonfm, none, rawfm, xml, xmlfm

مثال

طلب GET

الحصول على معلومات عن ‎action=parse و ‎prop=info ووحدة استفسار برمجية وهمية:

النتيجة

{
"warnings":{
"paraminfo":{
"*":"The module \"query\" does not have a submodule \"blah\"."
}
},
"paraminfo":{
"helpformat":"none",
"modules":[
{
"name":"parse",
"classname":"ApiParse",
"path":"parse",
...
},
{
"name":"info",
"classname":"ApiQueryInfo",
"path":"query+info",
...
}
]
}
}

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

Python

#!/usr/bin/python3
"""
 paraminfo.py
 MediaWiki API Demos
 Demo of `Paraminfo` module: Obtain information about other modules.
 MIT License
"""
importrequests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
 "action": "paraminfo",
 "format": "json",
 "modules": "parse|query+info|query"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
print(DATA)

PHP

<?php
/*
 paraminfo.php
 MediaWiki API Demos
 Demo of `Paraminfo` module: Get information about other action API modules and their parameters.
 MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
 "action" => "paraminfo",
 "format" => "json",
 "modules" => "parse|query+info|query"
];
$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

/*
 paraminfo.js
 MediaWiki API Demos
 Demo of `Paraminfo` module: Get information about other action API modules and their parameters.
 MIT License
*/
varurl="https://en.wikipedia.org/w/api.php";
varparams={
action:"paraminfo",
format:"json",
modules:"parse|query+info|query"
};
url=url+"?origin=*";
Object.keys(params).forEach(function(key){url+="&"+key+"="+params[key];});
fetch(url)
.then(function(response){returnresponse.json();})
.then(function(response){console.log(response);})
.catch(function(error){console.log(error);});

MediaWiki JS

/*
	paraminfo.js
	MediaWiki API Demos
	Demo of `Paraminfo` module: Get information about other action API modules and their parameters.
	MIT License
*/
varparams={
action:'paraminfo',
format:'json',
modules:'parse|query+info|query'
},
api=newmw.Api();
api.get(params).done(function(data){
console.log(data);
});

تاريخ المتغيرات

  • v1.25:
    • ‏‏querymodules, mainmodule, pagesetmodule, formatmodule متقادم
      بينما أن pagesetmodule غير متوافر بصورة ملحوظة في متغير modules، أضيفت متغيراته إلى الوحدات البرمجية التي تنطبق عليها. على سبيل المثال، المتغير ‎modules=purge سوف يرد titles و pageids وخلافه.
    • إضافة helpformat
  • v1.19: إضافة formatmodules
  • v1.15: إضافة pagesetmodule, mainmodule

انظر أيضا

AltStyle によって変換されたページ (->オリジナル) /