DELETE (/users/xuid(xuid)/lists/PINS/)
从列表中移除项。 这些 URI 的域为eplists.xboxlive.com。
备注
要移除的项通过其在列表中的索引指示,并在查询字符串参数 indexes 中标识。索引列表必须以逗号分隔,并且单次调用最多只能传递 100 个索引。但是,如果未传递任何索引(查询字符串参数为空),则将删除整个列表的内容(仍会保留一个空列表,且版本号会继续递增)。移除项之后,列表会被“压缩”,以便索引顺序中不会留下空洞。因此,此调用不是幂等的。 此调用要求在请求中包含 If-Match:versionNumber 标头,其中 versionNumber 为文件的当前版本号。如果未包含,或者与当前列表版本号不匹配,则将返回 HTTP 412(precondition failed)状态代码,并且响应正文将包含该列表的最新元数据(其中包含当前版本号)。这样做是为了防止来自不同客户端的更新相互覆盖。URI 参数
查询字符串参数
示例:indexes=1,8 会移除索引 1 和 8 处的项。索引必须唯一。如果未提供任何索引,则将清除整个列表。
授权
此调用期望在 Authorization 标头中传入 XSTS SAML 令牌。该 SAML 令牌中必须存在 Xuid 声明以标识调用者。此值用于确定调用者是否具有访问相关列表数据的权限。列表本身也将由 Xuid 标识,并将包含在列表的 URI 中。基于此机制,将来我们可能支持对列表的共享访问,但目前尚不支持此功能。当前,用户访问的所有列表都是其自己的,并且没有共享访问。因此,URI 中的 Xuid 必须与 SAML 声明令牌中的 Xuid 相匹配。注意:
目前同时支持 XBL Auth 2.0 和 3.0 令牌。