GET (/users//summary)

從呼叫端的角度取得擁有者的摘要資料。

URI 參數
授權
必要的要求標頭
選用的要求標頭
要求本文
HTTP 狀態碼
必要的回應標頭
回應本文

URI 參數

參數	類型	描述
ownerId	string	要存取其資源之使用者的識別碼。可能的值為 “me”、xuid() 或 gt()。範例值：`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 狀態碼。 | 代碼| 原因片語| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 已成功擷取工作階段。| | 400| Bad Request| 使用者識別碼的格式不正確。| | 403| Forbidden| 無法從授權標頭剖析 XUID 宣告。|

必要的回應標頭

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

回應本文

請參閱 PersonSummary (JSON)。

回應範例

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

另請參閱

上層

/users//summary

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

GET (/users/{ownerId}/summary)

GET (/users//summary)

URI 參數

授權

必要的要求標頭

選用的要求標頭

要求本文

HTTP 狀態碼

必要的回應標頭

回應本文

回應範例

另請參閱

上層

​GET (/users//summary)

​URI 參數

​授權

​必要的要求標頭

​選用的要求標頭

​要求本文

​HTTP 狀態碼

​必要的回應標頭

​回應本文

​回應範例

​另請參閱

上層

GET (/users//summary)

URI 參數

授權

必要的要求標頭

選用的要求標頭

要求本文

HTTP 狀態碼

必要的回應標頭

回應本文

回應範例

另請參閱