MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：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
- 版本的註釋。若是已刪除修訂的註釋，會回傳 commenthidden 屬性。
- 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 都添加
- 多值 (以 | 或 alternative 分隔)：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-hk
- iiextmetadatamultilang
若用於 extmetadata 屬性的翻譯可用，則全部索取。
- 類型：布林值（詳細資訊）
- iiextmetadatafilter
若有指定且非空，僅會為 iiprop=extmetadata 回傳這些鍵。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50（用於客戶端允許的較高限制為 500）。
- iiurlparam
處理器特定參數字串。例如 PDFs 可使用 page15-100px。必須要使用到 iiurlwidth 且要與 iiurlparam 一致。
- 預設值：(空)
- iibadfilecontexttitle
若有設定 badfilecontexttitleprop=badfile，此頁面使用在當評估 MediaWiki:Bad image list 的時候
- iicontinue
當有更多結果可用時，使用這個繼續。
- iilocalonly
僅查看在本地端儲存庫的檔案。
- 類型：布林值（詳細資訊）
![[在沙盒中開啟]](/wiki/%E7%89%B9%E6%AE%8A:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[在沙盒中開啟]](/wiki/%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}