MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/API
prop=imageinfo （ii）
- 此模組需要讀取權限。
- 來源：MediaWiki
- 協定：GPL-2.0-or-later
回傳檔案資訊與上傳日誌。
參數：
- iiprop
要取得的檔案資訊：
- timestamp
- 添加上傳版本的時間戳記。
- user
- 添加上傳了各檔案版本的使用者。
- userid
- 添加上傳了各檔案版本的使用者 ID。
- comment
- 版本的註釋。
- parsedcomment
- 解析版本上的註釋。
- canonicaltitle
- 添加檔案的規範標題。
- url
- 提供檔案與描述頁面的 URL。
- size
- 添加文件大小（字节）及其高度、宽度和页面数（如果可以）。
- dimensions
- 用于大小的别名。
- sha1
- 替檔案添加 SHA-1 雜湊值。
- mime
- 替檔案添加 MIME 類型。
- thumbmime
- 添加圖片縮圖的 MIME 類型（需要 url 與參數 iiurlwidth）。
- mediatype
- 添加檔案的媒體類型。
- metadata
- 列出檔案版本的 Exif 詮釋資料。
- commonmetadata
- 列出檔案版本的檔案格式通用詮釋資料。
- extmetadata
- 列出结合自多个来源的格式化的元数据。结果均依HTML格式化。
- archivename
- 添加非最新版本的存檔版本檔案名稱。
- bitdepth
- 添加版本的位元深度。
- uploadwarning
- 由 Special:Upload 頁面所使用來取得有關現有檔案的資訊。不適用於 MediaWiki 核心之外。
- badfile
- 無論檔案是否在 MediaWiki:Bad image list 都添加
- 多值 (以 | 或 alternative 分隔)：timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、thumbmime、mediatype、metadata、commonmetadata、extmetadata、archivename、bitdepth、uploadwarning、badfile
- 預設值：timestamp|user
- iilimit
每個檔案要回傳的檔案修訂數量。
- 不允許超過 500 (機器人為 5,000)。
- 類型：整數或max
- 預設值：1
- iistart
列出的起始時間戳記。
- 類型：時間戳記（允許格式）
- iiend
列出的終止時間戳記。
- 類型：時間戳記（允許格式）
- iiurlwidth
如果iiprop=url被设定，将返回至缩放到此宽度的一张图片的URL。 由于性能原因，如果此消息被使用，将不会返回超过50张被缩放的图片。
- 類型：整數
- 預設值：-1
- iiurlheight
與 iiurlwidth 相似。
- 類型：整數
- 預設值：-1
- iimetadataversion
要使用的元数据版本。如果latest被指定，则使用最新版本。默认为1以便向下兼容。
- 預設值：1
- iiextmetadatalanguage
要取得extmetadata的语言。这会影响到抓取翻译的选择，如果有多个可用的话，还会影响到数字等数值的格式。
- 預設值：zh-tw
- iiextmetadatamultilang
如果用于extmetadata属性的翻译可用，则全部取得。
- 類型：布林值（詳細資訊）
- iiextmetadatafilter
若有指定且非空，僅會為 iiprop=extmetadata 回傳這些鍵。
- 將幾個值以 | 或 alternative 分隔。 上限值為 50 (機器人為 500)。
- iiurlparam
处理器特定的参数字符串。例如PDF可能使用page15-100px。iiurlwidth必须被使用，并与iiurlparam一致。
- 預設值：(空)
- iibadfilecontexttitle
如果badfilecontexttitleprop=badfile被设置，这会是在评估MediaWiki:Bad image list时使用的页面标题
- iicontinue
當有更多結果可用時，使用這個繼續。
- iilocalonly
僅查看在本地端儲存庫的檔案。
- 類型：布林值（詳細資訊）
![[在沙盒中開啟]](/%E7%89%B9%E6%AE%8A:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[在沙盒中開啟]](/%E7%89%B9%E6%AE%8A:ApiSandbox#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp%7Cuser%7Curl){kind=link}