POST (/system/strings/validate)
検証する文字列の配列を受け入れ、等しいサイズの結果の配列を返します。
これらの URI のドメインは client-strings.xboxlive.com です。
解説
各結果は、対応する文字列が Xbox LIVE で許容可能かどうかを示します。必要に応じて問題のある文字列が含まれます。
同一の文字列は常に同一の結果を提供します。 成功以外の結果を受け取った場合は、結果を分析し、文字列を変更します。
注:
結果として得られる VerifyStringResult は、文字列内の最初の問題のある単語のみを報告します。 文字列には他にも問題のある単語が含まれている場合があります。 問題のある単語を置き換えて文字列を使用可能にする場合は、問題のある単語またはサブ文字列を置き換え、文字列を再検証して問題のあるその他のサブ文字列を検索します。
必須の要求ヘッダー
| ヘッダー | 説明 |
|---|---|
| Authorization | 認証トークン。 Example: 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 | OK | すべての文字列が正しく処理されました。 これは、すべての文字列に正の HResults が含まれていたことを必ずしも意味しません。 |
| 401 | 未承認 | 要求にはユーザー認証が必要です。 |
| 403 | Forbidden | ユーザーまたはサービスに対して要求が許可されていません。 |
| 406 | Not Acceptable | Content-type: application/json ヘッダーがありません。 |
| 408 | Request Timeout | サービスは無効な形式の要求を解釈できませんでした。 通常は、無効なパラメーターです。 |
応答の本文
要求配列と同じサイズの VerifyStringResult (JSON) の配列を返します。