Skip to main content

POST (/system/strings/validate)

接受一个字符串数组进行验证,并返回一个大小相同的结果数组。 这些 URI 的域为 client-strings.xboxlive.com。

备注

每个结果指示对应的字符串在 XBOX LIVE 上是否可接受,并在适用时包含违规字符串。 相同的字符串始终产生相同的结果。如果收到不成功的结果,请分析该结果并相应地修改字符串。
注意:
生成的 VerifyStringResult 仅报告字符串中的第一个违规词。字符串中可能还有其他违规词。如果计划替换违规词以使字符串可用,则应替换该违规词或子字符串,然后重新验证字符串以查找其他违规子字符串。

必需的请求标头

| 标头 | 说明 | | --- | --- | --- | | Authorization | 身份验证令牌。示例:XBL3.0 x=[hash];[token]。 | | x-xbl-contract-version | 整数 API 协定版本。对于此 API,必须为 1 或 2。 |

请求正文

请求正文是一个字符串数组,数组大小无限制,每个字符串 512 个字符。

请求示例

HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的某个状态代码。有关与 XBOX Live 服务一同使用的标准 HTTP 状态代码的完整列表,请参见 标准 HTTP 状态代码。 | 代码 | 原因短语 | 说明 | | --- | --- | --- | --- | --- | --- | | 200 | OK | 所有字符串均已成功处理。这不一定意味着所有字符串都具有正的 HResult。 | | 401 | Unauthorized | 请求需要用户身份验证。 | | 403 | Forbidden | 不允许该用户或服务发出请求。 | | 406 | Not Acceptable | 缺少 Content-type: application/json 标头。 | | 408 | Request Timeout | 服务无法理解格式错误的请求。通常是无效参数。 |

响应正文

返回一个 VerifyStringResult (JSON) 数组,大小与请求数组相同。

另请参阅

父主题
/system/strings/validate
Last modified on October 19, 2026