Skip to main content

​
POST (/users//people/xuids)

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

​
備考

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

​
URI パラメーター

​
認可

| 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)」を参照してください。|

​
オプション メンバー

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

​
禁止メンバー

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

​
リクエスト例

​
HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「標準 HTTP ステータス コード」を参照してください。 | 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)」を参照してください。

​
レスポンス例

​
関連項目

親
/users//people/xuids
Last modified on October 19, 2026