> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/users/xuid({xuid})/outbox)

> POST (/users/xuid({xuid})/outbox)

# POST (/users/xuid({xuid})/outbox)

將指定的訊息傳送給收件者清單。
這些 URI 的網域為 `msg.xboxlive.com`。

* [備註](#ID4EV)
* [URI 參數](#ID4EAB)
* [授權](#ID4ENB)
* [隱私權設定對資源的影響](#ID4EYB)
* [要求本文](#ID4E3F)
* [HTTP 狀態碼](#ID4ETCAC)
* [回應本文](#ID4E1EAC)

<a id="ID4EV" />

## 備註

此 API 唯一支援的內容類型為 "application/json"，每次呼叫的 HTTP 標頭中都必須包含此內容類型。

<a id="ID4EAB" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| xuid | 不帶正負號的 64 位元整數 | 提出要求之玩家的 XBOX 使用者識別碼 (XUID)。 |

<a id="ID4ENB" />

## 授權

您必須擁有自己的使用者宣告及有效的金會員訂閱，才能傳送使用者訊息。

<a id="ID4EYB" />

## 隱私權設定對資源的影響

成功傳送使用者訊息給玩家 (無論該玩家是否為好友) 都會產生結果碼 200。不過，如果您傳送訊息給已封鎖您的人，收件者將不會收到該訊息，而且您也不會收到任何訊息未成功傳送的指示。

每天可傳送的訊息數目，以及可傳送給多少好友和非好友，也有下列限制。

* 每則訊息 20 個陌生人
* 每 24 小時 200 個陌生人
* 每 24 小時總共 250 則訊息
* 每 24 小時總共 2500 個收件者

\| 提出要求的使用者| 目標使用者的隱私權設定| 行為|
\| --- | --- | --- | --- | --- | --- |
\| 我| -| 如上所述。|
\| 好友| 所有人| 200 OK|
\| 好友| 僅限好友| 200 OK|
\| 好友| 已封鎖| 200 OK|
\| 非好友使用者| 所有人| 200 OK|
\| 非好友使用者| 僅限好友| 200 OK|
\| 非好友使用者| 已封鎖| 200 OK|
\| 協力廠商網站| 所有人| 200 OK|
\| 協力廠商網站| 僅限好友| 200 OK|
\| 協力廠商網站| 已封鎖| 200 OK|

<a id="ID4E3F" />

## 要求本文

| 屬性 | 類型 | 最大長度 | 取用者 | 備註 |
| - | - | - | - | - |
| header | Header | | 全部 | 使用者訊息標頭 |
| messageText | string | 250 | Windows 8 以外的所有平台 | 使用者訊息文字 (UTF-8) |

#### Header

| 屬性 | 類型 | 最大長度 | 取用者 | 備註 |
| - | - | - | - | - |
| recipients | User\[] | 20 | 全部 | 訊息收件者清單 |

#### User

| 屬性 | 類型 | 最大長度 | 取用者 | 備註 |
| - | - | - | - | - |
| xuid | ulong | | 全部 | 收件者的 XUID。如果傳送了玩家代號，則不會使用。 |
| gamertag | string | 15 | 全部 | 收件者的玩家代號。如果傳送了 XUID，則不會使用。 |

#### 範例要求本文

```cpp theme={null}
{
          "header":
          {
            "recipients":
            [{"gamertag":"GoTeamEmily"},
            {"gamertag":"Longstreet360"}]
          },
          "messageText":"random user text"
        }

```

<a id="ID4ETCAC" />

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/reference/live/rest/additional/httpstatuscodes)。

\| 代碼| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| 成功。|
\| 400| 收件者清單為空白或超過最大長度；或同時指定了玩家代號和 XUID；或 messageText 太長。|
\| 403| 無法轉換 XUID。|
\| 404| 玩家代號無效或找不到使用者。|
\| 409| 使用者已達到系統強制的每日限制。|
\| 500| 一般伺服器端錯誤。|

<a id="ID4E1EAC" />

## 回應本文

回應的本文中不會傳送任何物件。

<a id="ID4EJFAC" />

## 另請參閱

<a id="ID4ELFAC" />

##### 上層

[/users/xuid({xuid})/outbox](/zh-TW/reference/live/rest/uri/users/uri-usersxuidoutbox)

<a id="ID4EZFAC" />

##### 參考  [標準 HTTP 狀態碼](/zh-TW/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblSocialSubmitReputationFeedbackAsync](/fr-CA/reference/live/xsapi-c/social_c/functions/xblsocialsubmitreputationfeedbackasync.md)
- [XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)