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 6, 2026