PUT (/users/xuid(xuid)/lists/PINS/)
依據要求本文中為每個項目指定的索引,更新清單中的項目。 這些 URI 的網域是eplists.xboxlive.com。
備註
此呼叫會依據要求本文中為每個項目指定的索引,更新清單中的項目。此呼叫不會將項目插入清單,如果指定的索引處不存在項目,則呼叫會傳回 400 Bad Request 狀態。單一呼叫中可以更新多個項目,但所有項目都必須存在於目前的清單中。也就是說,要麼全部更新,要麼全部不更新。 此呼叫允許以 itemId 而非 index 來指定要更新的項目。若要這麼做,只需在傳送給服務的 IndexedItems 結構中,將索引設為 “-1” 即可。顯然在此情況下,itemId 無法在更新時變更,因此僅適用於變更其他中繼資料欄位。也可以使用 provider/providerId 組合取代 itemId 來識別項目。服務會在內部搜尋清單中的這些項目,並找出要更新的正確索引。如果找不到該項目或這些項目,則會傳回 400 Bad Request 狀態,且不會更新任何項目。 如果使用索引來識別項目,此呼叫要求在要求中包含 If-Match:versionNumber 標頭。如果使用項目識別碼來識別項目 (且清單不允許重複項目),則 If-Match 標頭為選用。如果存在 if-Match 標頭,一律會進行驗證。在標頭中,versionNumber 是清單目前的版本號碼。如果未包含此標頭 (且為必要),或與清單目前的版本號碼不符,則會傳回 HTTP 412 Precondition Failed 狀態碼,且回應本文會包含清單的最新中繼資料,其中包括目前的版本號碼。這是為了防止來自不同用戶端的更新互相覆蓋。URI 參數
授權
此呼叫預期 Authorization 標頭中有 XSTS SAML 權杖。該 SAML 權杖中必須存在 Xuid 宣告,以識別呼叫端。此值用於判斷呼叫端是否具有相關清單資料的存取權限。清單本身也會以 Xuid 識別,並包含在清單的 URI 中。藉此,我們未來可能會支援清單的共用存取,但目前尚未提供此功能。目前,使用者存取的所有清單都是使用者自己的清單,沒有共用存取。因此,URI 中的 Xuid 必須與 SAML 宣告權杖中的 Xuid 相符。注意:
目前同時支援 XBL Auth 2.0 和 3.0 權杖。
