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 标头。如果使用项 ID 来标识项(并且列表不允许重复),则 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 令牌。