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

呼び出し元の people コレクションから XUID で個人を取得します。
これらの URI のドメインは `social.xboxlive.com` です。

* [備考](#ID4EV)
* [URI パラメーター](#ID4E5)
* [認可](#ID4EJB)
* [必須リクエスト ヘッダー](#ID4ERC)
* [オプションのリクエスト ヘッダー](#ID4EBE)
* [リクエスト本文](#ID4EHF)
* [HTTP ステータス コード](#ID4EKH)
* [必須レスポンス ヘッダー](#ID4ENBAC)
* [レスポンス本文](#ID4EZCAC)

## 備考

POST 操作はリソースを変更しないため、1 回実行しても複数回実行しても同じ結果が得られます。

## URI パラメーター

| Parameter | Type | Description |
| - | - | - |
| ownerId | string | アクセス対象のリソースを持つユーザーの識別子。認証済みのユーザーと一致する必要があります。指定可能な値は "me"、xuid({xuid})、または gt({gamertag}) です。 |

## 認可

\| Type| Required| Description| Response if missing|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| yes| 呼び出し元はユーザーの XBOX User ID (XUID) を持っています。| 401 Unauthorized|

## 必須リクエスト ヘッダー

\| Header| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| String。XBOX LIVE の認証データ。通常は暗号化された XSTS トークンです。値の例: **XBL3.0 x=\<userhash>;\<token>**。|
\| Content-Length| 32-bit unsigned integer。リクエスト本文のバイト単位の長さ。値の例: 22。|
\| Content-Type| String。リクエスト本文の MIME タイプ。**application/json** である必要があります。|

## オプションのリクエスト ヘッダー

\| Header| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion| リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。既定値: 1。|
\| Accept| String。呼び出し元がレスポンスで受け入れる Content-Type。すべてのレスポンスは **application/json** です。|

## リクエスト本文

### 必須メンバー

\| Member| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XuidList| 呼び出し元の people コレクションから返される個人を識別する XUID の配列。「[XuidList (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-xuidlist)」を参照してください。|

### オプション メンバー

このリクエストにはオプション メンバーはありません。

### 禁止メンバー

リクエスト内の他のすべてのメンバーは禁止されています。

### リクエスト例

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

## HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「[標準 HTTP ステータス コード](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes)」を参照してください。

\| Code| Reason phrase| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| メソッドが "get" の場合の成功。|
\| 204| No Content| メソッドが "add" または "remove" の場合の成功。|
\| 400| Bad Request| メソッド パラメーターが欠落しているか形式が正しくない、またはユーザー ID の形式が正しくありませんでした。|
\| 403| Forbidden| 認証ヘッダーから XUID クレームを解析できませんでした。|

## 必須レスポンス ヘッダー

\| Header| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Length| 32-bit unsigned integer| レスポンス本文のバイト単位の長さ。値の例: 22。|
\| Content-Type| string| レスポンス本文の MIME タイプ。常に **application/json** です。|

## レスポンス本文

レスポンス本文は、リクエスト メソッドが "get" の場合のみ送信されます。"add" または "remove" の場合はレスポンス本文はありません。

"get" メソッドの呼び出しが成功した場合、サービスは呼び出し元の people コレクション内の人物の総数と、呼び出し元の people コレクションを含む配列を返します。"add" と "remove" メソッドではレスポンスは返されません。「[PeopleList (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-peoplelist)」を参照してください。

### レスポンス例

```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
}
         
```

## 関連項目

##### 親

[/users/{ownerId}/people/xuids](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/people/uri-usersowneridpeoplexuids)


## Related topics

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