GET (/users//people/)

依目標識別碼從呼叫端的連絡人集合中取得某個人員。這些 URI 的網域為 social.xboxlive.com。

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

備註

GET 作業不會修改任何資源，因此無論執行一次或多次，都會產生相同的結果。

URI 參數

參數	類型	描述
ownerId	string	要存取其資源之使用者的識別碼。必須與已驗證的使用者相符。可能的值為 “me”、xuid() 或 gt()。
targetid	string	要從擁有者的 People 清單中擷取其資料之使用者的識別碼，可以是 XBOX 使用者識別碼 (XUID) 或玩家代號。範例值：xuid(2603643534573581)、gt(SomeGamertag)。

授權

| 類型| 必要| 描述| 遺漏時的回應| | --- | --- | --- | --- | --- | --- | --- | | XUID| 是| 呼叫端擁有使用者的 XBOX 使用者識別碼 (XUID)。| 401 Unauthorized|

必要的要求標頭

| 標頭| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| 字串。XBOX LIVE 的授權資料。這通常是加密的 XSTS 權杖。範例值：XBL3.0 x=<userhash>;<token>。|

選用的要求標頭

| 標頭| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。預設值：1。| | Accept| 字串。呼叫端在回應中接受的 Content-Type。所有回應都是 application/json。|

要求本文

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

HTTP 狀態碼

服務會針對使用此方法對此資源發出的要求，傳回本節中的其中一個狀態碼。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱標準 HTTP 狀態碼。 | 代碼| 原因片語| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 成功。| | 400| Bad Request| 使用者識別碼的格式不正確。| | 403| Forbidden| 無法從授權標頭剖析 XUID 宣告。| | 404| Not Found| 在擁有者的 People 清單中找不到目標使用者。|

必要的回應標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| 32 位元不帶正負號的整數| 回應本文的長度 (以位元組為單位)。範例值：22。| | Content-Type| string| 回應本文的 MIME 類型。此值一律為 application/json。|

回應本文

如果呼叫成功，服務會傳回目標人員。請參閱 Person (JSON)。

回應範例

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

另請參閱

上層

/users//people/

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

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

GET (/users//people/)

備註

URI 參數

授權

必要的要求標頭

選用的要求標頭

要求本文

HTTP 狀態碼

必要的回應標頭

回應本文

回應範例

另請參閱

上層

​GET (/users//people/)

​備註

​URI 參數

​授權

​必要的要求標頭

​選用的要求標頭

​要求本文

​HTTP 狀態碼

​必要的回應標頭

​回應本文

​回應範例

​另請參閱

上層

GET (/users//people/)

備註

URI 參數

授權

必要的要求標頭

選用的要求標頭

要求本文

HTTP 狀態碼

必要的回應標頭

回應本文

回應範例

另請參閱