> ## 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)

Obtém um conjunto de respostas sim ou não sobre se o usuário tem permissão para executar as ações especificadas com um conjunto de usuários de destino.

* [Comentários](#ID4EQ)
* [Parâmetros de URI](#ID4ECB)
* [Autorização](#ID4ENB)
* [Cabeçalhos de solicitação obrigatórios](#ID4ESC)
* [Corpo da solicitação](#ID4E4D)
* [Códigos de status HTTP](#ID4ETE)
* [Cabeçalhos de resposta obrigatórios](#ID4EIG)
* [Corpo da resposta](#ID4E5H)

<a id="ID4EQ" />

## Comentários

O corpo da solicitação recebe uma lista de usuários e uma lista de configurações, e o resultado é um resultado permitido/bloqueado para cada par usuário/configuração.

Em cenários multijogador entre redes (em que as verificações de privacidade de comunicação devem ser executadas entre usuários que têm uma ID de usuário do XBOX (XUID) e usuários fora da rede que não têm), consulte [PermissionCheckBatchRequest (JSON)](/pt-BR/reference/live/rest/json/json-permissioncheckbatchrequest) para obter os tipos de usuário.

<a id="ID4ECB" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| requestorId | string | Obrigatório. Identificador do usuário que executa a ação. Os valores possíveis são <code>xuid({xuid})</code> e <code>me</code>. Deve ser um usuário conectado. Valor de exemplo: <code>xuid(0987654321)</code>. |

<a id="ID4ENB" />

## Autorização

Declarações de autorização usadas | Declaração| Tipo| Obrigatório?| Valor de exemplo|
\| --- | --- | --- | --- | --- | --- | --- |
\| Xuid| inteiro com sinal de 64 bits| sim| 1234567890|

<a id="ID4ESC" />

## Cabeçalhos de solicitação obrigatórios

\| Cabeçalho| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| Credenciais de autenticação para autenticação HTTP. Valores de exemplo: <code>XBL3.0 x=\<userhash>;\<token></code>|
\| X-RequestedServiceVersion| string| Nome/número do build do serviço XBOX LIVE para o qual esta solicitação deve ser direcionada. A solicitação só será roteada para esse serviço após a verificação da validade do cabeçalho, das declarações no token de autenticação etc. Valor de exemplo: 1.|

<a id="ID4E4D" />

## Corpo da solicitação

<a id="ID4EDE" />

### Membros obrigatórios

Confira [PermissionCheckBatchRequest (JSON)](/pt-BR/reference/live/rest/json/json-permissioncheckbatchrequest).

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

```

<a id="ID4ETE" />

## Códigos de status HTTP

O serviço retorna um dos códigos de status desta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os XBOX Live Services, confira [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes).

\| Código| Frase de motivo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| A sessão foi recuperada com sucesso.|
\| 400| A solicitação é inválida.| Exemplos: IDs de configuração incorretas, URIs incorretos etc.|
\| 404| O usuário especificado no URI não existe.| Não foi possível encontrar o recurso especificado.|

<a id="ID4EIG" />

## Cabeçalhos de resposta obrigatórios

\| Cabeçalho| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Type| string| O tipo MIME do corpo da solicitação. Valor de exemplo: <code>application/json</code>|
\| Content-Length| string| O número de bytes enviados na resposta. Valor de exemplo: 34|
\| Cache-Control| string| Solicitação educada do servidor para especificar o comportamento de cache. Exemplo: <code>no-cache, no-store</code>|

<a id="ID4E5H" />

## Corpo da resposta

Confira [PermissionCheckBatchResponse (JSON)](/pt-BR/reference/live/rest/json/json-permissioncheckbatchresponse).

<a id="ID4ELAAC" />

### Exemplo de resposta

```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"}
                    ]
                }
            ]
        }
    ]
}

```

<a id="ID4EVAAC" />

## Confira também

<a id="ID4EXAAC" />

##### Pai

[/users/{requestorId}/permission/validate](/pt-BR/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidate)

[Enumeração PermissionId](/pt-BR/reference/live/rest/enums/privacy-enum-permissionid)


## Related topics

- [PermissionId Enumeration](/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Enumeración PermissionId](/es/reference/live/rest/enums/privacy-enum-permissionid.md)
- [PermissionId 枚举](/zh-CN/reference/live/rest/enums/privacy-enum-permissionid.md)
- [PermissionId 列挙体](/ja-jp/reference/live/rest/enums/privacy-enum-permissionid.md)
- [XblPermissionDenyReason](/reference/live/xsapi-c/privacy_c/enums/xblpermissiondenyreason.md)