Skip to main content

GET (/users/xuid()/inbox/)

特定のユーザー メッセージの詳細なメッセージ テキストを取得し、サービス上で既読としてマークします。 これらの URI のドメインは msg.xboxlive.com です。

解説

get 操作は、User、System、および FriendRequest のメッセージ タイプでのみ実行できます。 この URI は Xbox.com での更新が必要です。現在、XBOX 360 では、ユーザーがサインアウトして再度サインインするまで、既読/未読の状態は更新されません。 この API がサポートするコンテンツ タイプは “application/json” のみで、各呼び出しの HTTP ヘッダーで必須です。

URI パラメーター

認可

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

要求本文

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

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

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

HTTP 状態コード

サービスは、このリソースに対してこのメソッドを使用して行われた要求への応答として、このセクションのいずれかの状態コードを返します。XBOX Live サービスで使用される標準 HTTP 状態コードの完全な一覧については、「標準 HTTP 状態コード」を参照してください。 | コード | 説明 | | --- | --- | --- | --- | --- | | 200 | 成功。 | | 400 | XUID を正しく変換できません。 | | 403 | XUID を変換できないか、有効な XUID クレームが見つかりません。 | | 404 | 有効な XUID が指定されていないか、メッセージ ID が見つからないか、正しく解析されません。 | | 500 | 一般的なサーバー側のエラー、またはメッセージ タイプが GET に有効ではありません。 |

JavaScript Object Notation (JSON) 応答

正常に呼び出された場合、サービスは結果データを JSON 形式で返します。ルート オブジェクトは UserMessageHeader オブジェクトです。

UserMessageHeader

応答例

エラー応答

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

関連項目

親
/users/xuid()/inbox
リファレンス 標準 HTTP 状態コード
Last modified on October 19, 2026