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

# POST (/users/{ownerId}/people/xuids)

> POST (/users/{ownerId}/people/xuids)

# POST (/users/{ownerId}/people/xuids)

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

* [備註](#ID4EV)
* [URI 參數](#ID4E5)
* [授權](#ID4EJB)
* [必要的要求標頭](#ID4ERC)
* [選用的要求標頭](#ID4EBE)
* [要求本文](#ID4EHF)
* [HTTP 狀態碼](#ID4EKH)
* [必要的回應標頭](#ID4ENBAC)
* [回應本文](#ID4EZCAC)

<a id="ID4EV" />

## 備註

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

<a id="ID4E5" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| ownerId | string | 要存取其資源之使用者的識別碼。必須與已驗證的使用者相符。可能的值為 "me"、xuid({xuid}) 或 gt({gamertag})。 |

<a id="ID4EJB" />

## 授權

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

<a id="ID4ERC" />

## 必要的要求標頭

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

<a id="ID4EBE" />

## 選用的要求標頭

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

<a id="ID4EHF" />

## 要求本文

<a id="ID4ENF" />

### 必要成員

\| 成員| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XuidList| XUID 的陣列，用來識別要從呼叫端連絡人集合中傳回的人員。請參閱 [XuidList (JSON)](/zh-TW/reference/live/rest/json/json-xuidlist)。|

<a id="ID4EKG" />

### 選用成員

此要求沒有選用成員。

<a id="ID4EVG" />

### 禁止的成員

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

<a id="ID4EAH" />

### 要求範例

```cpp theme={null}
{
    "xuids": [
        "2533274790395904", 
        "2533274792986770", 
        "2533274794866999"
    ]
}
      
```

<a id="ID4EKH" />

## HTTP 狀態碼

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

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 方法為 "get" 時表示成功。|
\| 204| No Content| 方法為 "add" 或 "remove" 時表示成功。|
\| 400| Bad Request| 方法參數遺漏或格式不正確，或使用者識別碼的格式不正確。|
\| 403| Forbidden| 無法從授權標頭剖析 XUID 宣告。|

<a id="ID4ENBAC" />

## 必要的回應標頭

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

<a id="ID4EZCAC" />

## 回應本文

只有在要求方法為 "get" 時才會傳送回應本文。"add" 或 "remove" 沒有回應本文。

如果 "get" 方法呼叫成功，服務會傳回呼叫端連絡人集合中的人員總數，以及包含呼叫端連絡人集合的陣列。"add" 和 "remove" 方法不會傳回任何回應。請參閱 [PeopleList (JSON)](/zh-TW/reference/live/rest/json/json-peoplelist)。

<a id="ID4EHDAC" />

### 回應範例

```cpp theme={null}
{
    "people": [
        {
            "xuid": "2603643534573573",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573572",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573577",
            "isFavorite": false,
            "isFollowingCaller": false
        },
    ],
    "totalCount": 3
}
         
```

<a id="ID4ERDAC" />

## 另請參閱

<a id="ID4ETDAC" />

##### 上層

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


## Related topics

- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)
- [People 시스템에서 사람 표시하기](/ko/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)