MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=wbsetreference
(main | wbsetreference)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:WikibaseClient
- 授權條款:GPL-2.0-or-later
建立參考文獻或是設定現有參考文獻的值。
具體參數:
其他通用參數可用。
- statement
識別用於所設定參考文獻的聲明之 GUID
- 此為必填參數。
- snaks
要設定參考文獻的敘述。帶有屬性 ID 的 JSON 物件,會指向包含用於此屬性之敘述的陣列
- 此為必填參數。
- snaks-order
敘述的排序。屬性 ID 字串的 JSON 陣列
- reference
應更新的參考文獻雜湊,可選用。當不提供時,會建立一個新的參考文獻
- index
在聲明的參考文獻清單裡,移動參考文獻所在的索引,可選用。若未提供,已存在參考文獻將留在所附加新參考文獻的位置。
- 類型:整數
- summary
編輯的摘要。 會自動產生註釋來附加在開頭。摘要與自動註釋的共同長度限制是 260 個字元,請注意超出限制的任何內容將會被去除。
更改標籤來套用到修訂。
- 多值 (以 | 或 alternative 分隔):
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
- 此為必填參數。
- baserevid
基於變動的修訂之數字識別碼。 此用於在儲存期間偵測衝突。
- 類型:整數
- bot
標註此為機器人編輯。該 URL 標記僅會在使用者隸屬「bot」群組時採用。
- 類型:布林值(詳細資訊)
範例:
- 建立用於 GUID 為 Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF 聲稱的新參考文獻
- api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&snaks={"P212":[{"snaktype":"value","property":"P212","datavalue":{"type":"string","value":"foo"}}]}&baserevid=7201010&token=foobar [在沙盒中開啟]
- 設定用於 GUID 為 Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF、且雜湊為 1eb8793c002b1d9820c833d234a1b54c8e94187e 聲稱的參考文獻
- api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&reference=1eb8793c002b1d9820c833d234a1b54c8e94187e&snaks={"P212":[{"snaktype":"value","property":"P212","datavalue":{"type":"string","value":"bar"}}]}&baserevid=7201010&token=foobar [在沙盒中開啟]
- 替 GUID 為 Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF 的聲稱建立參考文獻,並插入新參考文獻至參考文獻清單頂部而非末端。
- api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&snaks={"P212":[{"snaktype":"novalue","property":"P212"}]}&index=0&baserevid=7201010&token=foobar [在沙盒中開啟]