API:属性

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

这是一个可以获取选定页面的属性列表的GET请求。

API帮助文档

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

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

询问应该写的像这样:action=query&titles=title1&prop=property1|property2

属性查询一般都会有一个返回个数的上限。 为了查询更多的项目,您需要在查询后面追加结果的continue 元素里面的值。

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

附加提醒

大多数属性子模块,除非另外指明,都可被用于生成器

  • 属性查询限制:
    • 属性查询的结果都有一个上限,默认为10 对于一般用户可以设到 500 , 而对于拥有 apihighlimits 权限的用户(一般是管理员或者机器人)可以到 5000 。 有些子模块也有更严的限制。

如果您不确定您的上限是多少,而您想要尽可能多的结果,那就请将上限设为max。 此时,会返回一个limits元素,这就是您的查询上限。

    • 对一个模块的限制参数包含那个模块的前缀,后面跟着limit. 例如,imlimit是返回的images的上限。

参阅