Skip to main content

POST (/users/xuid()/outbox)

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

備註

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

URI 參數

授權

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

隱私權設定對資源的影響

成功傳送使用者訊息給玩家 (無論該玩家是否為好友) 都會產生結果碼 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|

要求本文

User

範例要求本文

HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼,以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單,請參閱標準 HTTP 狀態碼。 | 代碼| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| 成功。| | 400| 收件者清單為空白或超過最大長度;或同時指定了玩家代號和 XUID;或 messageText 太長。| | 403| 無法轉換 XUID。| | 404| 玩家代號無效或找不到使用者。| | 409| 使用者已達到系統強制的每日限制。| | 500| 一般伺服器端錯誤。|

回應本文

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

另請參閱

上層
/users/xuid()/outbox
參考 標準 HTTP 狀態碼
Last modified on October 6, 2026