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

Paging Info

响应示例

错误响应

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

另请参阅

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