Skip to main content

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 物件標記法 (JSON) 回應

如果呼叫成功,服務會以 JSON 格式傳回結果資料。

Message

分頁資訊

範例回應

錯誤回應

發生錯誤時,服務可能會傳回 errorResponse 物件,其中可能包含來自服務環境的值。 | 屬性| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | errorSource| string| 錯誤來源的指示。| | errorCode| int| 與錯誤相關聯的數值代碼 (可以是 null)。| | errorMessage| string| 如果設定為顯示詳細資料,則為錯誤的詳細資料。|

另請參閱

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