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

# GET (/users/{ownerId}/summary)

> GET (/users/{ownerId}/summary)

# GET (/users/{ownerId}/summary)

从调用方的角度获取所有者的摘要数据。

* [URI 参数](#ID4EQ)
* [授权](#ID4E2)
* [必需的请求标头](#ID4EBC)
* [可选的请求标头](#ID4EHD)
* [请求正文](#ID4EXE)
* [HTTP 状态代码](#ID4ECF)
* [必需的响应标头](#ID4EZG)
* [响应正文](#ID4EGAAC)

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| ownerId | string | 正在访问其资源的用户的标识符。可能的值为 "me"、xuid({xuid}) 或 gt({gamertag})。示例值:`me`、`xuid(2603643534573581)`、`gt(SomeGamertag)` |

## 授权

\| **名称** | **类型** | **说明** |
\| --- | --- | --- | --- | --- | --- |
\| xuid | 64 位无符号整数 | 必需。调用方的用户标识符。示例值:2533274790395904 |

## 必需的请求标头

\| 标头 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization | string | 授权数据。这通常是经过加密的 XSTS 令牌。示例值:**XBL3.0 x=\[hash];\[token]**。 |

## 可选的请求标头

\| 标头 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version | string | 此请求应指向的服务的生成名称/编号。仅在验证标头的有效性、身份验证令牌中的声明等的有效性之后,请求才会路由到该服务。示例值:1 |
\| Accept | string | 可接受的 Content-Type。所有响应均将为 `application/json`。 |

## 请求正文

此请求正文中未发送任何对象。

## HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的一个状态代码。有关 XBOX Live 服务使用的标准 HTTP 状态代码的完整列表,请参阅[标准 HTTP 状态代码](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/httpstatuscodes)。

\| 代码 | 原因短语 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200 | OK | 已成功检索会话。 |
\| 400 | Bad Request | 用户 ID 格式错误。 |
\| 403 | Forbidden | 无法从授权标头解析 XUID 声明。 |

## 必需的响应标头

\| 标头 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Length | string | 响应中发送的字节数。示例值:232。 |
\| Content-Type | string | 响应正文的 MIME 类型。此项必须为 **application/json**。 |

## 响应正文

请参阅 [PersonSummary (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-personsummary)。

### 示例响应

```cpp theme={null}
{
    "targetFollowingCount": 87,
    "targetFollowerCount": 19,
    "isCallerFollowingTarget": true,
    "isTargetFollowingCaller": false,
    "hasCallerMarkedTargetAsFavorite": true,
    "hasCallerMarkedTargetAsKnown": true,
    "legacyFriendStatus": "None",
    "recentChangeCount": 5,
    "watermark": "5246775845000319351"
}

```

## 另请参阅

##### 父主题

[/users/{ownerId}/summary](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/people/uri-usersowneridsummary)


## Related topics

- [Crear lobby](https://devdocs.xbox.com/es/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)
- [Créer un lobby](https://devdocs.xbox.com/fr-CA/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)
- [Create Lobby](https://devdocs.xbox.com/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)
- [创建大厅](https://devdocs.xbox.com/zh-CN/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)
- [建立大廳](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)