MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=wbeditentity
(main | wbeditentity)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:WikibaseClient
- 授權條款:GPL-2.0-or-later
建立一個新 Wikibase 實體,並以序列化資訊來變動。
參數:
- id
用於實體的識別碼,包含字首。 使用 id,或是同時使用 site 與 title。
- new
若有設定,將會建立新的實體。 設定此為要建立的實體類型。 當也有設定 id 時,會不允許此設定。
- 單值:item、property
- site
於頁面所在處上的網站識別碼。 與 title 一起使用來產生完整的網站連結。
- 單值:tnfshwiki
- title
關聯的頁面標題。 與 site 一起使用來建立完整的網站連結。
- baserevid
基於變動的修訂之數字識別碼。 此用於在儲存期間偵測衝突。
- 類型:整數
- summary
編輯的摘要。 會自動產生註釋來附加在開頭。摘要與自動註釋的共同長度限制是 260 個字元,請注意超出限制的任何內容將會被去除。
- tags
更改標籤來套用到修訂。
- 多值 (以 | 或 alternative 分隔):delete、mobile edit、mobile web edit、wikipedia text
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
- 此為必填參數。
- bot
標註此為機器人編輯。該 URL 標記僅會在使用者隸屬「機器人」群組時採用。
- 類型:布林值(詳細資訊)
- data
作為資料來源的序列化物件。 新建立的實體會分配到一個 'id'。
- 此為必填參數。
- clear
若有設定,完整的實體會在處理前清空。 在填完「
data
」之前實體不會被保存,可能會排除一部份。- 類型:布林值(詳細資訊)
範例:
- 建立新的項目,回傳完整實體結構
- api.php?action=wbeditentity&new=item&data={} [在沙盒中開啟]
- 建立一個新項目,且設定 de 和 en 的標籤
- api.php?action=wbeditentity&new=item&data={"labels":{"de":{"language":"de","value":"de-value"},"en":{"language":"en","value":"en-value"}}} [在沙盒中開啟]
- 創建包含 json 資料的新屬性,回傳完整的實體結構
- api.php?action=wbeditentity&new=property&data={"labels":{"en-gb":{"language":"en-gb","value":"Propertylabel"}},"descriptions":{"en-gb":{"language":"en-gb","value":"Propertydescription"}},"datatype":"string"} [在沙盒中開啟]
- 清除所有來自 ID 為 Q999999998 實體的資料
- api.php?action=wbeditentity&clear=true&id=Q999999998&data={} [在沙盒中開啟]
- 清除來自 ID 為 Q999999998 實體的所有資料,並設定 en 標籤
- api.php?action=wbeditentity&clear=true&id=Q999999998&data={"labels":{"en":{"language":"en","value":"en-value"}}} [在沙盒中開啟]
- 若已存在,添加的標籤不要覆蓋
- api.php?action=wbeditentity&id=Q999999998&data={"labels":[{"language":"no","value":"Bar","add":""}]} [在沙盒中開啟]
- 移除一個標籤
- api.php?action=wbeditentity&id=Q999999998&data={"labels":[{"language":"en","value":"Foo","remove":""}]} [在沙盒中開啟]
- 設定 nowiki 的網站連結,若已存在則會覆蓋
- api.php?action=wbeditentity&id=Q999999998&data={"sitelinks":{"nowiki":{"site":"nowiki","title":"København"}}} [在沙盒中開啟]
- 設定 nb 的描述,若已存在則會覆蓋
- api.php?action=wbeditentity&id=Q999999998&data={"descriptions":{"nb":{"language":"nb","value":"nb-Description-Here"}}} [在沙盒中開啟]
- 在屬性是 P56 且值為「ExampleString」的項目上建立一個新聲稱
- api.php?action=wbeditentity&id=Q999999998&data={"claims":[{"mainsnak":{"snaktype":"value","property":"P56","datavalue":{"value":"ExampleString","type":"string"}},"type":"statement","rank":"normal"}]} [在沙盒中開啟]
- 從帶有所提供 GUID 的項目裡移除聲稱
- api.php?action=wbeditentity&id=Q999999998&data={"claims":[{"id":"Q999999998$D8404CDA-25E4-4334-AF13-A3290BCD9C0F","remove":""},{"id":"Q999999998$GH678DSA-01PQ-28XC-HJ90-DDFD9990126X","remove":""}]} [在沙盒中開啟]
- 將帶有 GUID 的聲稱設定成聲稱的值
- api.php?action=wbeditentity&id=Q999999998&data={"claims":[{"id":"Q999999998$GH678DSA-01PQ-28XC-HJ90-DDFD9990126X","mainsnak":{"snaktype":"value","property":"P56","datavalue":{"value":"ChangedString","type":"string"}},"type":"statement","rank":"normal"}]} [在沙盒中開啟]