GET (/users//people/)

Obtém uma pessoa pela ID de destino na coleção de pessoas do chamador. O domínio desses URIs é social.xboxlive.com.

Comentários
Parâmetros de URI
Autorização
Cabeçalhos de solicitação obrigatórios
Cabeçalhos de solicitação opcionais
Corpo da solicitação
Códigos de status HTTP
Cabeçalhos de resposta obrigatórios
Corpo da resposta

Comentários

As operações GET não modificam nenhum recurso, portanto produzirão os mesmos resultados se forem executadas uma ou várias vezes.

Parâmetros de URI

Parâmetro	Tipo	Descrição
ownerId	string	Identificador do usuário cujo recurso está sendo acessado. Deve corresponder ao usuário autenticado. Os valores possíveis são “me”, xuid() ou gt().
targetid	string	Identificador do usuário cujos dados estão sendo recuperados da lista de Pessoas do proprietário, seja uma ID de usuário do XBOX (XUID) ou um gamertag. Valores de exemplo: xuid(2603643534573581), gt(SomeGamertag).

Autorização

| Tipo| Obrigatório| Descrição| Resposta se ausente| | --- | --- | --- | --- | --- | --- | --- | | XUID| sim| O chamador tem a ID de usuário do XBOX (XUID) do usuário.| 401 Unauthorized|

Cabeçalhos de solicitação obrigatórios

| Cabeçalho| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| String. Dados de autorização para o XBOX LIVE. Normalmente, é um token XSTS criptografado. Valor de exemplo: XBL3.0 x=<userhash>;<token>.|

Cabeçalhos de solicitação opcionais

| Cabeçalho| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| 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 e assim por diante. Valor padrão: 1.| | Accept| String. Content-Types que o chamador aceita na resposta. Todas as respostas são application/json.|

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 Serviços do XBOX Live, confira Códigos de status HTTP padrão. | Código| Frase de motivo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| Êxito.| | 400| Bad Request| As IDs de usuário estavam malformadas.| | 403| Forbidden| Não foi possível analisar a declaração de XUID do cabeçalho de autorização.| | 404| Not Found| O usuário de destino não foi encontrado na lista de Pessoas do proprietário.|

Cabeçalhos de resposta obrigatórios

| Cabeçalho| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| inteiro sem sinal de 32 bits| Comprimento, em bytes, do corpo da resposta. Valor de exemplo: 22.| | Content-Type| string| Tipo MIME do corpo da resposta. Sempre será application/json.|

Corpo da resposta

Se a chamada for bem-sucedida, o serviço retornará a pessoa de destino. Confira Person (JSON).

Exemplo de resposta

{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}
         

Confira também

Pai

/users//people/

Porting

Build Paths

GET (/users/{ownerId}/people/{targetid})

GET (/users//people/)

Comentários

Parâmetros de URI

Autorização

Cabeçalhos de solicitação obrigatórios

Cabeçalhos de solicitação opcionais

Corpo da solicitação

Códigos de status HTTP

Cabeçalhos de resposta obrigatórios

Corpo da resposta

Exemplo de resposta

Confira também

Pai

​GET (/users//people/)

​Comentários

​Parâmetros de URI

​Autorização

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

​Cabeçalhos de solicitação opcionais

​Corpo da solicitação

​Códigos de status HTTP

​Cabeçalhos de resposta obrigatórios

​Corpo da resposta

​Exemplo de resposta

​Confira também

Pai

GET (/users//people/)

Comentários

Parâmetros de URI

Autorização

Cabeçalhos de solicitação obrigatórios

Cabeçalhos de solicitação opcionais

Corpo da solicitação

Códigos de status HTTP

Cabeçalhos de resposta obrigatórios

Corpo da resposta

Exemplo de resposta

Confira também