POST(/system/strings/validate)

아티클
05/09/2023

유효성 검사를 위해 문자열 배열을 허용하고 동일한 크기의 결과 배열을 반환합니다. 이 URI의 도메인은 client-strings.xboxlive.com입니다.

비고
필수 요청 헤더
요청 본문
HTTP 상태 코드
응답 본문

설명

각 결과는 해당 문자열이 Xbox LIVE에서 허용되는지 여부를 나타내며, 해당하는 경우 문제를 일으키는 문자열을 포함합니다.

동일한 문자열은 항상 동일한 결과를 제공합니다. 성공적이지 않은 결과를 받게 되는 경우 해당 결과를 분석하고 그에 따라 문자열을 수정합니다.

참고:
결과로 생성된 VerifyStringResult는 문자열에서 문제를 일으키는 첫 번째 단어만 보고합니다. 문자열 내에 추가로 문제를 일으키는 단어가 있을 수 있습니다. 문제를 일으키는 단어를 대체하여 문자열을 사용할 수 있게 하려면 문제를 일으키는 단어 또는 하위 문자열을 대체한 다음 문자열을 다시 확인하여 문제를 일으키는 추가 하위 문자열을 찾습니다.

필수 요청 헤더

헤더	설명
Authorization	인증 토큰. 예: 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	Unauthorized	요청에 대해 사용자 인증이 필요합니다.
403	Forbidden	사용자 또는 서비스에 대해 요청이 허용되지 않습니다.
406	Not Acceptable	Content-type: application/json 헤더가 누락되었습니다.
408	Request Timeout	서비스가 형식이 잘못된 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개 변수입니다.

응답 본문

요청 배열과 동일한 크기의 VerifyStringResult(JSON) 배열을 반환합니다.

참고 항목

부모

/system/strings/validate

다음을 통해 공유