POST (/system/strings/validate)

接受用于验证的字符串数组，并返回大小相同的结果数组。 这些 URI 的域是 client-strings.xboxlive.com。

• 备注
• 必需请求标头
• 请求正文
• HTTP 状态代码
• 响应正文

备注

每个结果都指示相应字符串在 Xbox LIVE 上是否可接受，并包含违规字符串（如果适用）。

相同的字符串始终提供相同的结果。 如果收到不成功的结果，则分析结果并相应地修改字符串。

注意：
生成的 VerifyStringResult 只会报告字符串中的第一个违规字。 字符串中可能还有其他违规字。 如果你计划替换违规字以使字符串可用，应替换违规字或子字符串，然后重新验证要查找的字符串是否包含其他违规的子字符串。

必需请求标头

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

请求正文

请求正文是一个字符串数组，对于数组大小没有限制，每个字符串 512 个字符。

示例请求

{
    "stringstoVerify":
    [
        "Poppycock",
        "The quick brown fox jumped over the lazy dog.",
        "Hey, want to play games together?",
        "oh noes"
    ]
}
      

HTTP 状态代码

服务返回此部分中的状态代码之一，以响应使用此方法对此资源发出的请求。 对于用于 Xbox Live 服务的标准 HTTP 状态代码的完整列表，请参阅标准 HTTP 状态代码。

代码	原因短语	说明
200	确定	成功处理了所有字符串。 这并不一定意味着所有字符串都具有正 HResult。
401	未授权	请求需要用户身份验证。
403	已禁止	用户或服务不允许此请求。
406	不可接受	缺少 Content-type: application/json 标头。
408	请求超时	服务无法理解格式错误的请求。 通常是无效参数。

响应正文

返回 VerifyStringResult (JSON) 数组，其大小与请求数组相同。

另请参阅

父级

/system/strings/validate