POST (/users/{requestorId}/permission/validate)
사용자가 대상 사용자 집합과 함께 지정된 작업을 수행할 수 있는지 여부에 대한 예 또는 아니요 대답 집합을 가져옵니다.
설명
요청 본문에는 사용자 목록과 설정 목록이 있으며 결과는 각 사용자/설정 쌍에 대해 허용/차단된 결과입니다.
교차 네트워크 멀티 플레이어 시나리오(Xbox 사용자 ID(XUID)가 있는 사용자와 그렇지 않은 네트워크 사용자 간에 개인 정보 통신 확인을 수행해야 하는 경우)는 PermissionCheckBatchRequest(JSON)를 참조하세요.
URI 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| requestorId | 문자열 | 필수. 작업을 수행하는 사용자의 식별자입니다. 가능한 값은 xuid({xuid}) 및 me입니다. 로그인한 사용자여야 합니다. 예제 값: xuid(0987654321). |
Authorization
| 사용된 권한 부여 클레임 | 클레임 | 유형 | 필수? | 예제 값 |
|---|---|---|---|---|
| Xuid | 64비트 부호 있는 정수 | 예 | 1234567890 |
필수 요청 헤더
| 헤더 | 유형 | 설명 |
|---|---|---|
| Authorization | 문자열 | HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: XBL3.0 x=<userhash>;<token> |
| X-RequestedServiceVersion | 문자열 | 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값은 1입니다. |
요청 본문
필수 멤버
PermissionCheckBatchRequest(JSON)를 참조하세요.
{
"users":
[
{"xuid":"12345"},
{"xuid":"54321"}
],
"permissions":
[
"ViewTargetGameHistory",
"ViewTargetProfile"
]
}
HTTP 상태 코드
서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.
| 코드 | 이유 구문 | 설명 |
|---|---|---|
| 200 | OK | 세션이 성공적으로 검색되었습니다. |
| 400 | 요청이 잘못되었습니다. | 예: 잘못된 설정 ID, 잘못된 URI 등 |
| 404 | URI에 지정된 사용자가 존재하지 않습니다. | 지정된 리소스를 찾을 수 없습니다. |
필수 응답 헤더
| 헤더 | 유형 | 설명 |
|---|---|---|
| 콘텐츠-종류 | 문자열 | 요청 본문의 MIME 유형입니다. 예제 값: application/json |
| Content-Length | 문자열 | 응답에서 전송되는 바이트 수입니다. 예제 값: 34 |
| Cache-Control | 문자열 | 캐싱 동작을 지정하는 서버의 형식적인 요청입니다. 예: no-cache, no-store |
응답 본문
PermissionCheckBatchResponse(JSON)를 참조하세요.
샘플 응답
{
"responses":
[
{
"user": {"xuid":"12345"},
"permissions":
[
{
"isAllowed":true
},
{
"isAllowed":true
}
]
},
{
"user": {"xuid":"54321"},
"permissions":
[
{
"isAllowed":false,
"reasons":
[
{"reason":"NotAllowed"}
]
},
{
"isAllowed":false,
"reasons":
[
{"reason":"PrivilegeRest", "restrictedSetting":"AllowProfileViewing"}
]
}
]
}
]
}