Skip to main content

POST (/users//permission/validate)

获取一组是/否答案,以确定该用户是否被允许对一组目标用户执行指定的操作。

备注

请求正文接受用户列表和设置列表,结果为每个用户/设置对的允许/阻止结果。 在跨网络多玩家场景(其中必须在具有 XBOX 用户 ID (XUID) 的用户与没有 XUID 的非网络用户之间执行隐私通信检查)下,请参阅 PermissionCheckBatchRequest (JSON) 了解用户类型。

URI 参数

授权

使用的授权声明 | 声明 | 类型 | 是否必需? | 示例值 | | --- | --- | --- | --- | --- | --- | --- | | Xuid | 64 位有符号整数 | 是 | 1234567890 |

必需的请求标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization | string | HTTP 身份验证的身份验证凭据。示例值:XBL3.0 x=<userhash>;<token> | | X-RequestedServiceVersion | string | 此请求应指向的 XBOX LIVE 服务的生成名称/编号。仅在验证标头的有效性、身份验证令牌中的声明等的有效性之后,请求才会路由到该服务。示例值:1。 |

请求正文

必需成员

请参阅 PermissionCheckBatchRequest (JSON)。

HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的一个状态代码。有关 XBOX Live 服务使用的标准 HTTP 状态代码的完整列表,请参阅标准 HTTP 状态代码。 | 代码 | 原因短语 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200 | OK | 已成功检索会话。 | | 400 | 请求无效。 | 示例:设置 ID 错误、URI 错误等。 | | 404 | URI 中指定的用户不存在。 | 找不到指定的资源。 |

必需的响应标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Type | string | 请求正文的 MIME 类型。示例值:application/json | | Content-Length | string | 响应中发送的字节数。示例值:34 | | Cache-Control | string | 服务器发出的用于指定缓存行为的礼貌请求。示例:no-cache, no-store |

响应正文

请参阅 PermissionCheckBatchResponse (JSON)。

示例响应

另请参阅

父主题
/users//permission/validate PermissionId 枚举
Last modified on October 19, 2026