返回会话的 4xx 状态代码始终返回整个会话,即使 URI 指向会话元素也是如此。
多人游戏会话状态代码
请求或更新 MPSD 多人游戏会话时 XBOX 服务返回的 HTTP 状态代码参考表,包括响应正文和含义。
本主题提供请求多人游戏会话时从 XBOX 服务返回的状态代码。
| 状态代码 | 字符串 | Content-Type | 正文 | 说明 |
|----|
| 200 | OK | application/json | Session | 已成功读取 (GET) 或更新 (PUT)。 |
| 201 | Created | application/json | Session | 已成功创建。 |
| 202 | Accepted | text/plain | None | 请求已被接受,但尚未完成。 |
| 204 | No content | | | 对会话执行 GET 时,会话不存在。对会话元素执行 GET 时,会话存在但元素不存在。对会话执行 PUT 时,由于 PUT 操作会话被删除。对会话元素执行 PUT 或 DELETE 时,操作开始时会话存在,但会话和元素都不存在。 |
| 304 | Not modified | | | 对具有 If-None-Match 标头的 GET 操作,会话未更改。 |
| 400 | Bad request | text/plain | Message | 首次检查时假定请求无效。它缺少必填字段或 JSON 文件格式错误。正文包含其他详细信息。 |
| 403 | Forbidden | text/plain | Message | 在某些上下文中请求可能有效,但对其上下文无效。授权失败。 |
| | | application/json | Session | 会话无法由用户更新,但可以读取。 |
| 404 | Not found | text/plain | Message | 由于 URI 无效而无法访问会话;找不到句柄、服务配置标识符 (SCID) 或会话模板;找不到 hopper;由于会话不存在而无法访问会话元素;或元素查找对于会话无效。 |
| 405 | Method not allowed | text/plain | Message | 请求 URI 合理,但动词错误。例如,在需要 PUT 操作时请求 POST 操作。 |
| 409 | Conflict | text/plain | Message | 由于请求与会话不兼容,无法更新会话。例如,请求中的常量与会话或会话模板中的常量冲突,或者已向大型会话添加或从其中删除了调用者以外的成员。 |
| 412 | Precondition failed | | | 无法满足 If-Match 标头或 If-None-Match 标头(用于 GET 以外的操作)。 |
| | | application/json | Session | 对现有会话执行 PUT 或 DELETE 操作时,无法满足 If-Match 标头。会话的当前状态与当前 ETag 值一起返回。 |
| 429 | Too many requests | application/json | Message | 由于超出细粒度速率限制 (FGRL) 限制,服务调用被限流。有关详细信息,请参阅细粒度速率限制。 |
| 503 | Service unavailable | text/plain | None | 服务过载,应稍后重试请求。此代码包括客户端应遵守的 Retry-After 标头。 |
最后修改于 2026年8月25日