GET (/users//summary)

呼び出し元の視点からオーナーに関するサマリーデータを取得します。

URI パラメーター
認可
必須リクエストヘッダー
オプションのリクエストヘッダー
リクエスト本文
HTTP ステータスコード
必須レスポンスヘッダー
レスポンス本文

URI パラメーター

Parameter	Type	Description
ownerId	string	アクセス対象のリソースを持つユーザーの識別子。指定可能な値は “me”、xuid()、または gt() です。値の例: `me`、`xuid(2603643534573581)`、`gt(SomeGamertag)`

認可

| Name| Type| Description| | --- | --- | --- | --- | --- | --- | | xuid| 64-bit unsigned integer| 必須。呼び出し元のユーザー識別子。値の例: 2533274790395904|

必須リクエストヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| の認証データ。通常は暗号化された XSTS トークンです。値の例: XBL3.0 x=[hash];[token]。|

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

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| string| リクエストのルーティング先となるサービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。値の例: 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 クレームを解析できませんでした。|

必須レスポンスヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| string| レスポンスで送信されるバイト数。値の例: 232。| | Content-Type| string| レスポンス本文の MIME タイプ。application/json である必要があります。|

レスポンス本文

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

レスポンス例

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

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

GET (/users/{ownerId}/summary)

GET (/users//summary)

URI パラメーター

認可

必須リクエストヘッダー

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

リクエスト本文

HTTP ステータスコード

必須レスポンスヘッダー

レスポンス本文

レスポンス例

関連項目

親

​GET (/users//summary)

​URI パラメーター

​認可

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

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

​リクエスト本文

​HTTP ステータス コード

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

​レスポンス本文

​レスポンス例

​関連項目

親

GET (/users//summary)

URI パラメーター

認可

必須リクエストヘッダー

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

リクエスト本文

HTTP ステータスコード

必須レスポンスヘッダー

レスポンス本文

レスポンス例

関連項目