Skip to main content

​
GET (/users//people/)

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

​
備考

GET 操作はリソースを変更しないため、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>。|

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

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

​
リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

​
HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「標準 HTTP ステータス コード」を参照してください。 | Code| Reason phrase| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 成功。| | 400| Bad Request| ユーザー ID の形式が正しくありませんでした。| | 403| Forbidden| 認証ヘッダーから XUID クレームを解析できませんでした。| | 404| Not Found| 対象ユーザーがオーナーの People リストに見つかりませんでした。|

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

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

​
レスポンス本文

呼び出しが成功すると、サービスは対象の person を返します。「Person (JSON)」を参照してください。

​
レスポンス例

​
関連項目

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