Skip to main content

POST (/users//people/xuids)

依 XUID 從呼叫端的連絡人集合中取得人員。 這些 URI 的網域為 social.xboxlive.com。

備註

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

URI 參數

授權

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

必要的要求標頭

| 標頭| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| 字串。XBOX LIVE 的授權資料。這通常是加密的 XSTS 權杖。範例值:XBL3.0 x=<userhash>;<token>。| | Content-Length| 32 位元不帶正負號的整數。要求本文的長度 (以位元組為單位)。範例值:22。| | Content-Type| 字串。要求本文的 MIME 類型。此值必須為 application/json。|

選用的要求標頭

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

要求本文

必要成員

| 成員| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | XuidList| XUID 的陣列,用來識別要從呼叫端連絡人集合中傳回的人員。請參閱 XuidList (JSON)。|

選用成員

此要求沒有選用成員。

禁止的成員

要求中禁止使用所有其他成員。

要求範例

HTTP 狀態碼

服務會針對使用此方法對此資源發出的要求,傳回本節中的其中一個狀態碼。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單,請參閱標準 HTTP 狀態碼。 | 代碼| 原因片語| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 方法為 “get” 時表示成功。| | 204| No Content| 方法為 “add” 或 “remove” 時表示成功。| | 400| Bad Request| 方法參數遺漏或格式不正確,或使用者識別碼的格式不正確。| | 403| Forbidden| 無法從授權標頭剖析 XUID 宣告。|

必要的回應標頭

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

回應本文

只有在要求方法為 “get” 時才會傳送回應本文。“add” 或 “remove” 沒有回應本文。 如果 “get” 方法呼叫成功,服務會傳回呼叫端連絡人集合中的人員總數,以及包含呼叫端連絡人集合的陣列。“add” 和 “remove” 方法不會傳回任何回應。請參閱 PeopleList (JSON)。

回應範例

另請參閱

上層
/users//people/xuids
Last modified on October 6, 2026