Skip to main content

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

检索特定用户消息的详细消息文本,并在服务上将其标记为已读。 这些 URI 的域为 msg.xboxlive.com。

备注

get 操作只能对 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,或找不到消息 ID 或解析不正确。 | | 500 | 常规服务器端错误,或消息类型对 GET 无效。 |

JavaScript 对象表示法 (JSON) 响应

如果调用成功,服务将以 JSON 格式返回结果数据。根对象为 UserMessageHeader 对象。

UserMessageHeader

响应示例

错误响应

出错时,服务可能返回 errorResponse 对象,其中可能包含来自服务环境的值。 | 属性 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | errorSource | string | 错误来源的指示。 | | errorCode | int | 与错误关联的数字代码(可以为 null)。 | | errorMessage | string | 如果配置为显示详细信息,则显示错误的详细信息。 |

另请参阅

父主题
/users/xuid()/inbox
参考资料 标准 HTTP 状态代码
Last modified on October 19, 2026