MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
list=allimages <pre>(ai) </pre>
- 此模組需要讀取權限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
按顺序枚举所有图像。
參數:
- aisort
要作为排序方式的属性。
- 單值:name、timestamp
- 預設值:name
- aidir
罗列所采用的方向。
- 單值:ascending、descending、newer、older
- 預設值:ascending
- aifrom
要列举的起始图片标题。只能与aisort=name一起使用。
- aito
要列举的最终图片标题。只能与aisort=name一起使用。
- aicontinue
当更多结果可用时,使用这个继续。
- aistart
要列举的起始时间戳。只能与aisort=timestamp一起使用。
- 类型:时间戳(允许格式)
- aiend
要列举的最终时间戳。只能与aisort=timestamp一起使用。
- 类型:时间戳(允许格式)
- aiprop
要获取的文件信息:
- timestamp
- 添加时间戳至上传的版本。
- user
- 添加上传了每个文件版本的用户。
- userid
- 添加上传了每个文件版本的用户ID。
- comment
- 此版本的摘要。
- parsedcomment
- 解析版本上的注释。
- canonicaltitle
- 添加文件的规范标题。
- url
- 为文件及其描述页面提供URL。
- size
- 添加文件大小(字节)及其高度、宽度和页面数(如果可以)。
- dimensions
- 用于大小的别名。
- sha1
- 为文件加入SHA-1哈希值。
- mime
- 添加文件的MIME类型。
- mediatype
- 添加文件媒体类型。
- metadata
- 列出这个版本的文件的EXIF元数据。
- commonmetadata
- 为文件的修订版本列出文件格式相关元数据。
- extmetadata
- 列出结合自多个来源的格式化的元数据。结果均依HTML格式化。
- bitdepth
- 添加修订的字节深度。
- 多值 (以 | 分隔):timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、mediatype、metadata、commonmetadata、extmetadata、bitdepth
- 預設值:timestamp|url
- aiprefix
搜索所有以此值开头的图像标题。只能与aisort=name一起使用。
- aiminsize
限于至少这么多字节的图像。
- 类型:整数
- aimaxsize
限于顶多这么多字节的图像。
- 类型:整数
- aisha1
图像的 SHA1 哈希。覆盖aisha1base36。
- aisha1base36
基于base 36的图片的SHA1哈希值(用于MediaWiki)。
- aiuser
只返回此用户上传的文件。只能与aisort=timestamp一起使用。不能与aifilterbots一起使用。
- 类型:用户名
- aifilterbots
如何过滤由机器人上传的文件。只能与aisort=timestamp一起使用。不能与aiuser一起使用。
- 單值:all、bots、nobots
- 預設值:all
- aimime
要搜索的MIME类型,例如image/jpeg。
- 使用 | 分隔數值。 上限值為 50 (機器人為 500)。
- ailimit
要回傳的圖片總數。
- 不允許超過 500 (機器人為 5,000)。
- 类型:整数或max
- 預設值:10
範例:
- 显示以字母B开始的文件列表。
- api.php?action=query&list=allimages&aifrom=B
- 显示一个最近上传文件的列表,类似Special:NewFiles。
- api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older
- 显示带MIME类型image/png或image/gif的文件列表
- api.php?action=query&list=allimages&aimime=image/png|image/gif
- 显示有关4个以T开头的文件的信息。
- api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo