MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=allimages （ai）
- 此模組需要讀取權限。
- 此模組可作為產生器使用。
- 來源：MediaWiki
- 授權條款：GPL-2.0-or-later
按順序列舉所有圖片。
參數：
- 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
- 添加上傳了各檔案版本的使用者。若是已刪除修訂的使用者，會回傳 userhidden 屬性。
- userid
- 添加上傳了各檔案版本的使用者 ID。若修訂裡使用者已被刪除，會回傳 userhidden 屬性。
- comment
- 版本的註釋。若是已刪除修訂的註釋，會回傳 commenthidden 屬性。
- parsedcomment
- 解析版本上的註釋。若是已刪除修訂的解析註釋，會回傳 commenthidden 屬性。
- canonicaltitle
- 添加檔案的規範標題。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- url
- 提供檔案與描述頁面的 URL。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- size
- 添加以位元組為單位的檔案大小、高度、寬度、頁面計數（若可套用的話）。
- dimensions
- 大小的別名。
- sha1
- 替檔案添加 SHA-1 雜湊值。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- mime
- 替檔案添加 MIME 類型。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- mediatype
- 添加檔案的媒體類型。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- metadata
- 列出檔案版本的 Exif 詮釋資料。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- commonmetadata
- 列出檔案版本的檔案格式通用詮釋資料。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- extmetadata
- 列出結合多個來源的格式化詮釋資料。結果內容為 HTML 格式。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- bitdepth
- 添加版本的位元深度。若是已刪除修訂的檔案，會回傳 filehidden 屬性。
- badfile
- 無論檔案是否在 MediaWiki:Bad image list 都添加
- 多值 (以 | 或 alternative 分隔)：badfile、bitdepth、canonicaltitle、comment、commonmetadata、dimensions、extmetadata、mediatype、metadata、mime、parsedcomment、sha1、size、timestamp、url、user、userid
- 預設值：timestamp|url
- aiprefix
搜尋所有以此值為開頭的圖片。僅能與 aisort=name 一起使用。
- aiminsize
限制圖片至少要有這樣多的位元組。
- 類型：整數
- aimaxsize
限制圖片最多只能這樣多的位元組。
- 類型：整數
- aisha1
圖片的 SHA1 雜湊值。覆蓋 aisha1base36。
- aisha1base36
以 base 36 的圖片 SHA1 雜湊值（使用在 MediaWiki）。
- aiuser
僅回傳由此使用者上傳的檔案。僅能與 aisort=timestamp 一起使用，且不可與 aifilterbots 一起使用。
- 類型：使用者，按任何使用者名稱、IP、跨 wiki 名稱（例如："prefix>ExampleName"）以及使用者 ID（例如："#12345"）
- aifilterbots
如何篩選由機器人上傳的檔案。僅能與 aisort=timestamp 一起使用，且不可與 aiuser 一起使用。
- 單值：all、bots、nobots
- 預設值：all
- aimime
所要搜尋的 MIME 類型，例如：image/jpeg。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50（用於客戶端允許的較高限制為 500）。
- ailimit
要回傳的圖片總數。
- 類型：整數或max
- 數值必須在 1 與 500 之間。
- 預設值：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 [在沙盒中開啟]