メインコンテンツへスキップ

GET (/users/xuid()/inbox)

サービスから指定された数のユーザー メッセージのサマリを取得します。 これらの URI のドメインは msg.xboxlive.com です。

解説

ユーザー メッセージのサマリには、メッセージの件名のみが含まれます。ユーザー生成のメッセージの場合、現在はメッセージ テキストの最初の 20 文字です。システム メッセージでは、“LIVE System” のような代替の件名が提供されることがあります。 メッセージは送信された順序の逆順で返されます。つまり、より新しいメッセージが先に返されます。 この API がサポートするコンテンツ タイプは “application/json” のみで、各呼び出しの HTTP ヘッダーで必須です。

URI パラメーター

クエリ文字列パラメーター

| プロパティ | 型 | 最大長 | 解説 | | --- | --- | --- | --- | --- | --- | --- | | maxItems | int | 100 | 返されるメッセージの最大数。 | | continuationToken | string | | 前の列挙呼び出しで返された文字列。列挙を継続するために使用されます。 | | skipItems | int | 100 | スキップするメッセージ数。continuationToken が存在する場合は無視されます。 |

認可

ユーザー メッセージのサマリを取得するには、独自のユーザー クレームが必要です。

プライバシー設定がリソースに与える影響

自分のユーザー メッセージを列挙できるのは自分だけです。

HTTP 状態コード

サービスは、このリソースに対してこのメソッドを使用して行われた要求への応答として、このセクションのいずれかの状態コードを返します。XBOX Live サービスで使用される標準 HTTP 状態コードの完全な一覧については、「標準 HTTP 状態コード」を参照してください。 | コード | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200 | 要求は成功しました。 | | 400 | サービスは正しくない形式の要求を解釈できませんでした。通常は無効なパラメーターです。 | | 403 | 要求はユーザーまたはサービスに対して許可されていません。 | | 404 | URI に有効な XUID がありません。 | | 409 | 渡された継続トークンに基づく基礎となるコレクションが変更されました。 | | 416 | スキップする項目の数が、使用可能な項目の数より大きくなっています。 | | 500 | 一般的なサーバー側のエラーです。 |

JavaScript Object Notation (JSON) 応答

正常に呼び出された場合、サービスは結果データを JSON 形式で返します。

Message

Paging Info

応答例

エラー応答

エラーの場合、サービスはサービス環境の値を含む可能性がある errorResponse オブジェクトを返すことがあります。 | プロパティ | 型 | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | errorSource | string | エラーの発生元を示します。 | | errorCode | int | エラーに関連付けられた数値コード (null の場合があります)。 | | errorMessage | string | 詳細を表示するように構成されている場合のエラーの詳細。 |

関連項目

親
/users/xuid()/inbox
リファレンス 標準 HTTP 状態コード
最終更新日 2026年10月19日