MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子：-{R|https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page}-
prop=imageinfo （ii）
- 此模块需要读取权限。
- 来源：MediaWiki
- 许可协议：GPL-2.0-or-later
返回文件信息和上传历史。
参数：
- iiprop
要获取的文件信息：
- timestamp
- 添加时间戳至上传的版本。
- user
- 添加上传了各个文件版本的用户。若该用户已被删除修订，将返回userhidden属性。
- userid
- 添加上传了各个文件版本的用户的 ID。若该用户已被删除修订，将返回userhidden属性。
- comment
- 此版本的摘要。若该用户已被删除修订，将返回userhidden属性。
- parsedcomment
- 解析版本上的注释。若该注释已被删除修订，将返回commenthidden属性。
- canonicaltitle
- 添加文件的规范标题。若该文件已被删除修订，将返回filehidden属性。
- url
- 为文件及其描述页面提供 URL。若该文件已被删除修订，将返回filehidden属性。
- size
- 添加文件大小（字节）及其高度、宽度和页面数（如果可以）。
- dimensions
- 用于大小的别名。
- sha1
- 为文件加入 SHA-1 哈希值。若该文件已被删除修订，将返回filehidden属性。
- mime
- 添加文件的 MIME 类型。若该文件已被删除修订，将返回filehidden属性。
- thumbmime
- 添加图片缩略图的 MIME 类型（需要 url 和参数 iiurlwidth）。若该文件已被删除修订，将返回filehidden属性。
- mediatype
- 添加文件媒体类型。若该文件已被删除修订，将返回filehidden属性。
- metadata
- 列出这个版本的文件的 EXIF 元数据。若该文件已被删除修订，将返回filehidden属性。
- commonmetadata
- 为文件的修订版本列出文件格式通用元数据。若该文件已被删除修订，将返回filehidden属性。
- extmetadata
- 列出结合自多个来源的格式化的元数据。结果均依HTML格式化。如果文件已被修订删除，filehidden 属性会被退回。
- archivename
- 添加用于非最新修订的存档修订的文件名。如果文件已被修订删除，filehidden 属性会被退回。
- bitdepth
- 添加修订的字节深度。若该文件已被删除修订，将返回 filehidden 属性。
- uploadwarning
- 由Special:Upload所使用，以获取关于现有文件的信息。不适用于MediaWiki核心以外代码。
- badfile
- 无论文件是否在MediaWiki:Bad image list都添加
- 值（以|或替代物分隔）：archivename、badfile、bitdepth、canonicaltitle、comment、commonmetadata、dimensions、extmetadata、mediatype、metadata、mime、parsedcomment、sha1、size、thumbmime、timestamp、uploadwarning、url、user、userid
- 默认：timestamp|user
- iilimit
每个文件返回多少文件修订。
- 类型：整数或max
- 值必须介于1和500之间。
- 默认：1
- iistart
开始列举的时间戳。
- 类型：时间戳（允许格式）
- iiend
列举的结束时间戳。
- 类型：时间戳（允许格式）
- iiurlwidth
如果iiprop=url被设定，将返回至缩放到此宽度的一张图片的URL。 由于性能原因，如果此消息被使用，将不会返回超过50张被缩放的图片。
- 类型：整数
- 默认：-1
- iiurlheight
与iiurlwidth类似。
- 类型：整数
- 默认：-1
- iimetadataversion
要使用的元数据版本。如果latest被指定，则使用最新版本。默认为1以便向下兼容。
- 默认：1
- iiextmetadatalanguage
要取得extmetadata的语言。这会影响到抓取翻译的选择，如果有多个可用的话，还会影响到数字等数值的格式。
- 默认：zh
- iiextmetadatamultilang
如果用于extmetadata属性的翻译可用，则全部取得。
- 类型：布尔型 (详情)
- iiextmetadatafilter
如果指定且非空，则只为iiprop=extmetadata返回这些键。
- 通过|或替代物隔开各值。
- 值的最大值为50（允许更高上限的客户端为500）。
- iiurlparam
处理器特定的参数字符串。例如PDF可能使用page15-100px。iiurlwidth必须被使用，并与iiurlparam一致。
- 默认：（空）
- iibadfilecontexttitle
如果badfilecontexttitleprop=badfile被设置，这会是在评估MediaWiki:Bad image list时使用的页面标题
- iicontinue
当更多结果可用时，使用这个继续。可在 mediawiki.org 获取更多有关如何继续查询的详细信息。
- iilocalonly
只看本地存储库的文件。
- 类型：布尔型 (详情)
![[在沙盒中打开]](/zh/index.php?title=Special:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[在沙盒中打开]](/zh/index.php?title=Special:ApiSandbox#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url){kind=link}