GET (/users/{ownerId}/summary)

呼び出し元の視点から所有者に関する概要データを取得します。

• URI パラメーター
• Authorization
• 必須の要求ヘッダー
• 省略可能な要求ヘッダー
• リクエストの本文
• HTTP ステータス コード
• 必須の応答ヘッダー
• 応答の本文

URI パラメーター

パラメーター	型	説明
ownerId	文字列	アクセスするリソースを持つユーザーの ID。 指定できる値は "me"、xuid({xuid})、または gt({gamertag}) です。 値の例: me、xuid(2603643534573581)、gt(SomeGamertag)

Authorization

名前	Type	説明
xuid	64 ビット符号なし整数	必須。 呼び出し元のユーザー識別子。 値の例: 2533274790395904

必須の要求ヘッダー

ヘッダー	型	説明
Authorization	文字列	の承認データ。 通常、これは暗号化された XSTS トークンです。 値の例: XBL3.0 x=[hash];[token]。

省略可能な要求ヘッダー

ヘッダー	型	説明
x-xbl-contract-version	文字列	この要求の送信先であるサービスのビルド名/番号。 要求は、ヘッダー、認証トークン内のクレームなどの有効性が確認された後でのみ、そのサービスにルーティングされます。値の例: 1
Accept	文字列	受け入れ可能な Content-Type。 すべての応答は application/json です。

リクエストの本文

この要求の本体で送信されるオブジェクトはありません。

HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで実行された要求に応答して、このセクションのステータス コードのいずれかを返します。 Xbox Live サービスで使用される標準 HTTP ステータス コードの一覧については、「標準 HTTP ステータス コード」を参照してください。

コード	理由	説明
200	OK	セッションは正常に取得されました。
400	Bad Request	ユーザー ID の形式が正しくありませんでした。
403	Forbidden	承認ヘッダーから XUID クレームを解析できませんでした。

必須の応答ヘッダー

ヘッダー	型	説明
Content-Length	文字列	応答で送信されるバイト数。 値の例: 232。
Content-Type	文字列	応答本体の MIME タイプ。 これは application/json である必要があります。

応答の本文

「PersonSummary (JSON)」を参照してください。

サンプル応答

{
    "targetFollowingCount": 87,
    "targetFollowerCount": 19,
    "isCallerFollowingTarget": true,
    "isTargetFollowingCaller": false,
    "hasCallerMarkedTargetAsFavorite": true,
    "hasCallerMarkedTargetAsKnown": true,
    "legacyFriendStatus": "None",
    "recentChangeCount": 5,
    "watermark": "5246775845000319351"
}

関連項目

親

/users/{ownerId}/summary