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

<a id="ID4EQ" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| ownerId | string | 要存取其資源之使用者的識別碼。可能的值為 "me"、xuid({xuid}) 或 gt({gamertag})。範例值：<code>me</code>、<code>xuid(2603643534573581)</code>、<code>gt(SomeGamertag)</code> |

<a id="ID4E2" />

## 授權

\| <b>名稱</b>| <b>類型</b>| <b>描述</b>|
\| --- | --- | --- | --- | --- | --- |
\| xuid| 64 位元不帶正負號的整數| 必要。呼叫端的使用者識別碼。範例值：2533274790395904|

<a id="ID4EBC" />

## 必要的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| 的授權資料。這通常是加密的 XSTS 權杖。範例值：<b>XBL3.0 x=\[hash];\[token]</b>。|

<a id="ID4EHD" />

## 選用的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| string| 此要求應導向之服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。範例值：1|
\| Accept| string| 可接受的 Content-Type。所有回應都會是 <code>application/json</code>。|

<a id="ID4EXE" />

## 要求本文

此要求的本文中不會傳送任何物件。

<a id="ID4ECF" />

## HTTP 狀態碼

服務會針對使用此方法對此資源發出的要求，傳回本節中的其中一個狀態碼。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/reference/live/rest/additional/httpstatuscodes)。

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 已成功擷取工作階段。|
\| 400| Bad Request| 使用者識別碼的格式不正確。|
\| 403| Forbidden| 無法從授權標頭剖析 XUID 宣告。|

<a id="ID4EZG" />

## 必要的回應標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Length| string| 回應中傳送的位元組數目。範例值：232。|
\| Content-Type| string| 回應本文的 MIME 類型。此值必須為 <b>application/json</b>。|

<a id="ID4EGAAC" />

## 回應本文

請參閱 [PersonSummary (JSON)](/zh-TW/reference/live/rest/json/json-personsummary)。

<a id="ID4ESAAC" />

### 回應範例

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

```

<a id="ID4E3AAC" />

## 另請參閱

<a id="ID4E5AAC" />

##### 上層

[/users/{ownerId}/summary](/zh-TW/reference/live/rest/uri/people/uri-usersowneridsummary)


## Related topics

- [Crear Lobby](/es/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)
- [로비 만들기](/ko/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)
- [Créer un lobby](/fr-CA/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)
- [Create Lobby](/api-reference/lobby/create-lobby.md)
- [Criar Lobby](/pt-BR/services/playfab/api-references/rest/multiplayer/lobby/create-lobby.md)