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

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

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

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

Obtém uma resposta sim ou não sobre se o usuário tem permissão para executar a ação especificada com um usuário de destino.

* [Parâmetros de URI](#ID4EQ)
* [Parâmetros da cadeia de consulta](#ID4E2)
* [Autorização](#ID4EDC)
* [Cabeçalhos de solicitação obrigatórios](#ID4EID)
* [Corpo da solicitação](#ID4ETE)
* [Códigos de status HTTP](#ID4E5E)
* [Cabeçalhos de resposta obrigatórios](#ID4ETG)
* [Corpo da resposta](#ID4EKAAC)

## 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 `xuid()` e `me`. Deve ser um usuário conectado. Valor de exemplo: `xuid(0987654321)`. |

## Parâmetros da cadeia de consulta

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- |
\| setting| enumeração de cadeia de caracteres| O valor de PermissionId a ser verificado. Valor de exemplo: "CommunicateUsingText".|
\| target| string| Identificador do usuário no qual a ação deve ser executada. Os valores possíveis são `xuid()`. Valores de exemplo: `xuid(0987654321)`|

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

## 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: `XBL3.0 x=<userhash>;<token>`|
\| 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.|

## Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

## 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](https://docs.xbox.com/pt-BR/reference/live/rest/additional/httpstatuscodes.md).

\| 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.|

## 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: `application/json`|
\| 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: `no-cache, no-store`|

## Corpo da resposta

Confira [PermissionCheckResponse (JSON)](https://docs.xbox.com/pt-BR/reference/live/rest/json/json-permissioncheckresponse.md).

### Exemplo de resposta

```cpp theme={null}
{
    "isAllowed": false,
    "reasons":
    [
        {"reason": "BlockedByRequestor"},
        {"reason": "MissingPrivilege", "restrictedSetting": "VideoCommunications"}
    ]
}

```

## Confira também

##### Pai

[/users/{requestorId}/permission/validate](https://docs.xbox.com/pt-BR/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidate.md)

[Enumeração PermissionId](https://docs.xbox.com/pt-BR/reference/live/rest/enums/privacy-enum-permissionid.md)


## Related topics

- [/users/{requestorId}/permission/validate](https://docs.xbox.com/pt-BR/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidate.md)
- [POST (/users/{requestorId}/permission/validate)](https://docs.xbox.com/pt-BR/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidatepost.md)
- [Enumeração PermissionId](https://docs.xbox.com/pt-BR/reference/live/rest/enums/privacy-enum-permissionid.md)
- [URIs de privacidade](https://docs.xbox.com/pt-BR/reference/live/rest/uri/privacy/atoc-reference-privacyv2.md)
- [Visão geral de privacidade e permissões](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)