POST /users/xuid(xuid)/lists/PINS//ContainsItems

确定列表是否包含一组项(由 itemId 指定),而无需检索整个列表。这些 URI 的域为 eplists.xboxlive.com。

备注
URI 参数
查询字符串参数
请求正文
HTTP 状态代码
必需的请求标头
响应正文

备注

此端点允许调用者确定一个或多个项是否存在于指定的列表中,而无需实际获取列表并自行搜索。项集由 itemId(或 provider/providerId 组合)标识,返回数据是传入的数据,并带有 true 或 false 布尔值,以指示列表是否包含每个项。

URI 参数

参数	类型	说明
XUID	string	用户的 XUID。
listname	string	要操作的列表的名称。

查询字符串参数

不支持查询参数。

请求正文

{
  "Items":
  [{"ItemId":  "ed591a0c-dde3-563f-99af-530278a3c402",
    "ProviderId":  null,
    "Provider": null
  }]
}


    

HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的某个状态代码。有关与 XBOX Live 服务一同使用的标准 HTTP 状态代码的完整列表,请参见标准 HTTP 状态代码。

代码	原因短语	说明
200	OK	请求已成功完成。响应正文应包含所请求的资源(对于 GET)。POST 和 PUT 请求将收到最新的列表元数据(列表版本、计数等)。
201	Created	已创建新列表。这是在向列表进行初始插入时返回的。响应包含列表的最新元数据,并且位置标头包含该列表的 URI。
304	Not Modified	对 GET 返回。表示客户端已拥有该列表的最新版本。服务将 If-Match 标头中的值与列表版本进行比较。如果相等,则返回 304 且不带任何数据。
400	Bad Request	请求格式错误。可能是 URI 或查询字符串参数的值或类型无效。也可能是由于缺少必需的参数或数据值,或者请求指示了缺少或无效的 API 版本。请参见 X-XBL-Contract-Version 标头。
401	Unauthorized	请求需要用户身份验证。
403	Forbidden	不允许该用户或服务发出请求。
404	Not Found	调用者无权访问该资源。这表示尚未创建这样的列表。
412	Precondition Failed	表示列表的版本已更改,并且修改请求失败。修改请求是插入、更新或移除操作。服务会检查 If-Match 标头中的列表版本。如果与列表的当前版本不匹配,则该操作失败,并返回此代码以及当前列表的元数据(包括当前版本)。
500	Internal Server Error	由于服务器端错误,服务正在拒绝请求。
501	Not Implemented	调用者请求了尚未在服务器上实现的 URI。(当前仅在对未列入允许列表的列表名称发出请求时使用。)
503	Service Unavailable	服务器拒绝请求,通常是由于负载过大。经过延迟后(请参见 Retry-after 标头),可以重试请求。

必需的请求标头

标头	说明
Authorization	包含用于对请求进行身份验证和授权的 STS 令牌。必须是来自 XSTS 服务的令牌,并且包含 XUID 作为其中一项声明。
X-XBL-Contract-Version	指定正在请求的 API 版本(正整数)。Pin 支持版本 2。如果缺少此标头或值不受支持,则服务将返回 400 - Bad request,状态描述为 “Unsupported or missing contract version header”。
Content-Type	指定请求/响应正文的内容是 json 还是 xml。支持的值为 “application/json” 和 “application/xml”。
If-Match	发出修改请求时,此标头必须包含列表的当前版本号。修改请求使用 PUT、POST 或 DELETE 谓词。如果 “If-Match” 标头中的版本与列表的当前版本不匹配,则请求将被拒绝并返回 HTTP 412 - precondition failed 代码。(可选)也可用于 GET,如果存在并且传入的版本与当前列表版本匹配,则不返回任何列表数据并返回 HTTP 304 - Not Modified 代码。

响应正文

如果调用成功,则返回项列表,以及为每个项指定该项是否在列表中的布尔值。

响应示例

{
  "ContainedItems":
  [{"Contained": "true",
    "Item":
   {"ItemId":  "ed591a0c-dde3-563f-99af-530278a3c402",
    "ProviderId": null,
    "Provider": null
   }
  }]
}


      

另请参阅

父主题

通用资源标识符 (URI) 参考

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

POST /users/xuid(xuid)/lists/PINS/{listname}/ContainsItems

POST /users/xuid(xuid)/lists/PINS//ContainsItems

备注

URI 参数

查询字符串参数

请求正文

HTTP 状态代码

必需的请求标头

响应正文

响应示例

另请参阅

父主题

​POST /users/xuid(xuid)/lists/PINS//ContainsItems

​备注

​URI 参数

​查询字符串参数

​请求正文

​HTTP 状态代码

​必需的请求标头

​响应正文

​响应示例

​另请参阅

父主题

POST /users/xuid(xuid)/lists/PINS//ContainsItems

备注

URI 参数

查询字符串参数

请求正文

HTTP 状态代码

必需的请求标头

响应正文

响应示例

另请参阅