Skip to main content

GET (/users//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

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

Exemplo de resposta

Confira também

Pai
/users//permission/validate Enumeração PermissionId
Last modified on October 6, 2026