Skip to main content

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

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) para obter os tipos de usuário.

Parâmetros de URI

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

Membros obrigatórios

Confira PermissionCheckBatchRequest (JSON).

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 PermissionCheckBatchResponse (JSON).

Exemplo de resposta

Confira também

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