> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/system/strings/validate)

> POST (/system/strings/validate)

# POST (/system/strings/validate)

接受要驗證的字串陣列，並傳回相同大小的結果陣列。
這些 URI 的網域為 `client-strings.xboxlive.com`。

* [備註](#ID4EV)
* [必要的要求標頭](#ID4EIB)
* [要求本文](#ID4ELC)
* [HTTP 狀態碼](#ID4E4C)
* [回應本文](#ID4ETF)

## 備註

每個結果都會指出對應的字串在 XBOX LIVE 上是否可接受，並在適用時包含違規的字串。

相同的字串一律會產生相同的結果。如果您收到不成功的結果，請分析結果並據此修改字串。

> **注意：**\
> 產生的 **VerifyStringResult** 只會回報字串中的第一個違規字詞。字串中可能還有其他違規字詞。如果您打算取代違規字詞以讓字串可供使用，應該先取代違規字詞或子字串，然後再次驗證字串，以尋找其他違規的子字串。

## 必要的要求標頭

\| 標頭| 描述|
\| --- | --- | --- |
\| Authorization| 驗證權杖。範例：XBL3.0 x=\[hash];\[token]。|
\| x-xbl-contract-version| 整數 API 合約版本。此 API 必須為 1 或 2。|

## 要求本文

要求本文是字串陣列，陣列大小沒有限制，每個字串最多 512 個字元。

### 範例要求

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

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](https://docs.xbox.com/zh-TW/reference/live/rest/additional/httpstatuscodes.md)。

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- |
\| 200| OK| 已成功處理所有字串。這不一定表示所有字串都有正面的 HResult。|
\| 401| Unauthorized| 要求需要使用者驗證。|
\| 403| Forbidden| 不允許使用者或服務提出此要求。|
\| 406| Not Acceptable| 遺漏 **Content-type: application/json** 標頭。|
\| 408| Request Timeout| 服務無法理解格式錯誤的要求。通常是無效的參數。|

## 回應本文

傳回與要求陣列大小相同的 [VerifyStringResult (JSON)](https://docs.xbox.com/zh-TW/reference/live/rest/json/json-verifystringresult.md) 陣列。

## 另請參閱

##### 上層

[/system/strings/validate](https://docs.xbox.com/zh-TW/reference/live/rest/uri/stringserver/uri-systemstringsvalidate.md)


## Related topics

- [/system/strings/validate](https://docs.xbox.com/zh-TW/reference/live/rest/uri/stringserver/uri-systemstringsvalidate.md)
- [VerifyStringResult (JSON)](https://docs.xbox.com/zh-TW/reference/live/rest/json/json-verifystringresult.md)
- [系統字串驗證 URI](https://docs.xbox.com/zh-TW/reference/live/rest/uri/stringserver/atoc-reference-systemstringsvalidate.md)
- [Validate Entity Token](https://docs.xbox.com/api-reference/authentication/validate-entity-token.md)
- [Validate Api Policy](https://docs.xbox.com/api-reference/authentication/validate-api-policy.md)