Skip to main content

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

擷取特定使用者訊息的詳細訊息文字,並在服務上將其標示為已讀取。 這些 URI 的網域為 msg.xboxlive.com。

備註

取得作業只能在 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,或找不到訊息識別碼或剖析不正確。| | 500| 一般伺服器端錯誤,或訊息類型對 GET 無效。|

JavaScript 物件標記法 (JSON) 回應

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

UserMessageHeader

範例回應

錯誤回應

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

另請參閱

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