Skip to main content

​
POST (/users/xuid()/outbox)

指定されたメッセージを受信者のリストに送信します。 これらの URI のドメインは msg.xboxlive.com です。

​
解説

この API がサポートするコンテンツ タイプは “application/json” のみで、各呼び出しの HTTP ヘッダーで必須です。

​
URI パラメーター

​
認可

ユーザー メッセージを送信するには、独自のユーザー クレームと有効な Gold サブスクリプションが必要です。

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

プレイヤーがフレンドであるか否かにかかわらず、ユーザー メッセージをそのプレイヤーに正常に送信すると、200 の結果コードが返されます。ただし、自分をブロックしている相手にメッセージを送信した場合、受信者はそのメッセージを受け取らず、送信者側にはメッセージが失敗したことを示す表示は行われません。 また、1 日に送信できるメッセージ数、フレンドおよび非フレンドへの送信数には以下の制限があります。
  • メッセージあたり 20 人までの見知らぬユーザー
  • 24 時間あたり 200 人までの見知らぬユーザー
  • 24 時間あたり合計 250 メッセージ
  • 24 時間あたり合計 2500 人までの受信者
| 要求ユーザー | 対象ユーザーのプライバシー設定 | 動作 | | --- | --- | --- | --- | --- | --- | | me | - | 説明のとおり。 | | friend | everyone | 200 OK | | friend | friends only | 200 OK | | friend | blocked | 200 OK | | non-friend user | everyone | 200 OK | | non-friend user | friends only | 200 OK | | non-friend user | blocked | 200 OK | | third-party site | everyone | 200 OK | | third-party site | friends only | 200 OK | | third-party site | blocked | 200 OK |

​
要求本文

​
User

​
要求本文の例

​
HTTP 状態コード

サービスは、このリソースに対してこのメソッドを使用して行われた要求への応答として、このセクションのいずれかの状態コードを返します。XBOX Live サービスで使用される標準 HTTP 状態コードの完全な一覧については、「標準 HTTP 状態コード」を参照してください。 | コード | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200 | 成功。 | | 400 | 受信者のリストが空か、最大長を超えています。または、gamertag と XUID の両方が指定されました。または、messageText が長すぎます。 | | 403 | XUID を変換できません。 | | 404 | gamertag が無効か、ユーザーが見つかりません。 | | 409 | ユーザーがシステムによって課された 1 日の制限に達しました。 | | 500 | 一般的なサーバー側のエラーです。 |

​
応答本文

応答の本文にはオブジェクトは送信されません。

​
関連項目

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