API:属性

This page is a translated version of the page API:Properties and the translation is 100% complete.

本页是MediaWiki Action API帮助文档的一部分。

GET請求以列出所選頁面的屬性。

API帮助文档

属性是指关於页面的某些数据，例如分类、或者页面的内容，例如图片或链接。为了请求一个属性，你需要在你的询问的prop参数处放一个有效的属性子模块，与你要的信息对应。

您请求的页面通过询问的 titles, pageids, 或者 revids 参数指明, 或者通过一个生成器 .

針對屬性的询问是写成这样：action=query&titles=title1&prop=property1|property2

属性查询一般都会有一个返回个数的上限。若要查看更多項目，請將結果的continue 元素中的值附加到原始請求中。

请参考属性API各自的页面以阅读更加详细的实例。

大多数的属性子模块，除非另外指明，都可被用做生成器。
属性查询限制：
- 属性查询的结果都有一个上限，默认为10 对于一般用户结果上限可以设到500，而对于拥有apihighlimits权限的用户（一般是管理员或者机器人）可以到5000。有些子模块也有更严的限制。
- 如果您不确定您的上限是多少，而您想要的结果是多多益善，那就请将上限设为max。此时，会返回一个limits元素，这就是您的查询上限。
- 給定模組的限制參數由模組前綴後跟單字 limit 組成。例如，imlimit是返回的images的上限。

有关查询模块的文档 – 包含一个对所有属性子模块的概述，包含它们的对应参数和值
API:数据库字段与API属性关联 – 包含一个在Mediawiki数据库中和这个项关联的查询属性。
API:列表 – 一个类似的API，可以用来获取信息列表，就像allusers或recentchanges那样。不同於在pages后面附加資料的属性查询，列表會返回query的一个单独的分支。