> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/users/{requestorId}/permission/validate)

> POST (/users/{requestorId}/permission/validate)

# POST (/users/{requestorId}/permission/validate)

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

* [备注](#ID4EQ)
* [URI 参数](#ID4ECB)
* [授权](#ID4ENB)
* [必需的请求标头](#ID4ESC)
* [请求正文](#ID4E4D)
* [HTTP 状态代码](#ID4ETE)
* [必需的响应标头](#ID4EIG)
* [响应正文](#ID4E5H)

## 备注

请求正文接受用户列表和设置列表,结果为每个用户/设置对的允许/阻止结果。

在跨网络多玩家场景(其中必须在具有 XBOX 用户 ID (XUID) 的用户与没有 XUID 的非网络用户之间执行隐私通信检查)下,请参阅 [PermissionCheckBatchRequest (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-permissioncheckbatchrequest) 了解用户类型。

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| requestorId | string | 必需。执行操作的用户的标识符。可能的值为 `xuid()` 和 `me`。此项必须为已登录的用户。示例值:`xuid(0987654321)`。 |

## 授权

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

## 必需的请求标头

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

## 请求正文

### 必需成员

请参阅 [PermissionCheckBatchRequest (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-permissioncheckbatchrequest)。

```cpp theme={null}
{
    "users":
    [
        {"xuid":"12345"},
        {"xuid":"54321"}
    ],
    "permissions":
    [
        "ViewTargetGameHistory",
        "ViewTargetProfile"
    ]
}

```

## HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的一个状态代码。有关 XBOX Live 服务使用的标准 HTTP 状态代码的完整列表,请参阅[标准 HTTP 状态代码](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/httpstatuscodes)。

\| 代码 | 原因短语 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-permissioncheckbatchresponse)。

### 示例响应

```cpp theme={null}
{
    "responses":
    [
        {
            "user": {"xuid":"12345"},
            "permissions":
            [
                {
                    "isAllowed":true
                },
                {
                    "isAllowed":true
                }
            ]
        },
        {
            "user": {"xuid":"54321"},
            "permissions":
            [
                {
                    "isAllowed":false,
                    "reasons":
                    [
                        {"reason":"NotAllowed"}
                    ]
                },
                {
                    "isAllowed":false,
                    "reasons":
                    [
                        {"reason":"PrivilegeRest", "restrictedSetting":"AllowProfileViewing"}
                    ]
                }
            ]
        }
    ]
}

```

## 另请参阅

##### 父主题

[/users/{requestorId}/permission/validate](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidate)

[PermissionId 枚举](https://devdocs.xbox.com/zh-CN/reference/live/rest/enums/privacy-enum-permissionid.md)


## Related topics

- [PermissionId Enumeration](https://devdocs.xbox.com/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Enumeração PermissionId](https://devdocs.xbox.com/pt-BR/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Enumeración PermissionId](https://devdocs.xbox.com/es/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Énumération PermissionId](https://devdocs.xbox.com/fr/reference/live/rest/enums/privacy-enum-permissionid.md)
- [PermissionId 枚举](https://devdocs.xbox.com/zh-CN/reference/live/rest/enums/privacy-enum-permissionid.md)