POST (/users/xuid(xuid)/lists/PINS/)
根据查询字符串参数 insertIndex 将项插入到列表中的指定索引位置。 这些 URI 的域为eplists.xboxlive.com。
备注
此调用会根据查询字符串参数 insertIndex(默认为 0 或列表开头)将项插入到列表中的相应索引位置。请求正文中的所有项都将插入到列表中的该位置。如果 insertIndex 大于现有列表中的项数,则新项将被插入到末尾。 要插入的项必须包含功能规范中所指示的必填字段;否则,将返回 HTTP 400。同样,如果插入结果将超过列表的最大大小(按列表类型定义),则将返回 HTTP 400 并且不会插入任何内容。 如果不是将项插入到列表的开头或末尾,则请求中需要包含 If-Match:versionNumber 标头。如果插入的位置是开头或末尾,则该标头是可选的。如果存在,无论插入位置在何处,都将验证该标头。标头中的 VersionNumber 为列表的当前版本号。如果未包含且为必填,或者与当前列表版本号不匹配,则将返回 HTTP 412(precondition failed)状态代码,并且响应正文将包含该列表的最新元数据(其中包含当前版本号)。这样做是为了防止来自不同客户端的更新相互覆盖。 请注意,此调用不是幂等的;使用相同数据重复调用可能会导致多次插入。但是,由于当前没有列表支持重复项,因此重复调用可能会返回 HTTP 400 代码。URI 参数
查询字符串参数
授权
此调用期望在 Authorization 标头中传入 XSTS SAML 令牌。该 SAML 令牌中必须存在 Xuid 声明以标识调用者。此值用于确定调用者是否具有访问相关列表数据的权限。列表本身也将由 Xuid 标识,并将包含在列表的 URI 中。基于此机制,将来我们可能支持对列表的共享访问,但目前尚不支持此功能。当前,用户访问的所有列表都是其自己的,并且没有共享访问。因此,URI 中的 Xuid 必须与 SAML 声明令牌中的 Xuid 相匹配。注意:
目前同时支持 XBL Auth 2.0 和 3.0 令牌。