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

# POST (/users/{requestorId}/permission/validate)

> POST (/users/{requestorId}/permission/validate)

# POST (/users/{requestorId}/permission/validate)

사용자가 대상 사용자 집합에 대해 지정된 작업을 수행할 수 있는지에 대한 예/아니요 답변 집합을 가져옵니다.

* [설명](#ID4EQ)
* [URI 매개 변수](#ID4ECB)
* [권한 부여](#ID4ENB)
* [필수 요청 헤더](#ID4ESC)
* [요청 본문](#ID4E4D)
* [HTTP 상태 코드](#ID4ETE)
* [필수 응답 헤더](#ID4EIG)
* [응답 본문](#ID4E5H)

## 설명

요청 본문은 사용자 목록과 설정 목록을 받고, 각 사용자/설정 쌍에 대한 허용/차단 결과를 반환합니다.

크로스 네트워크 멀티플레이어 시나리오(XBOX User ID(XUID)가 있는 사용자와 이를 갖지 않은 오프네트워크 사용자 간에 개인 정보 통신 검사를 수행해야 하는 경우)에서 User 형식에 대해서는 [PermissionCheckBatchRequest (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-permissioncheckbatchrequest)를 참조하십시오.

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| requestorId | string | 필수. 작업을 수행하는 사용자의 식별자입니다. 가능한 값은 `xuid()` 및 `me`입니다. 로그인한 사용자여야 합니다. 예제 값: `xuid(0987654321)`. |

## 권한 부여

사용되는 권한 부여 클레임 | 클레임| 형식| 필수 여부| 예제 값|
\| --- | --- | --- | --- | --- | --- | --- |
\| Xuid| 64비트 부호 있는 정수| 예| 1234567890|

## 필수 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: `XBL3.0 x=<userhash>;<token>`|
\| X-RequestedServiceVersion| string| 이 요청이 라우팅되어야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 요청은 헤더의 유효성, 인증 토큰의 클레임 등을 확인한 후에만 해당 서비스로 라우팅됩니다. 예제 값: 1.|

## 요청 본문

### 필수 멤버

[PermissionCheckBatchRequest (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-permissioncheckbatchrequest)를 참조하십시오.

```cpp theme={null}
{
    "users":
    [
        {"xuid":"12345"},
        {"xuid":"54321"}
    ],
    "permissions":
    [
        "ViewTargetGameHistory",
        "ViewTargetProfile"
    ]
}

```

## HTTP 상태 코드

서비스는 이 리소스에서 이 메서드로 이루어진 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 [표준 HTTP 상태 코드](https://devdocs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes)를 참조하십시오.

\| 코드| 이유 구문| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 세션을 성공적으로 검색했습니다.|
\| 400| 요청이 잘못되었습니다.| 예: 잘못된 설정 ID, 잘못된 URI 등.|
\| 404| URI에 지정된 사용자가 존재하지 않습니다.| 지정된 리소스를 찾을 수 없습니다.|

## 필수 응답 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Type| string| 요청 본문의 MIME 형식입니다. 예제 값: `application/json`|
\| Content-Length| string| 응답으로 전송되는 바이트 수입니다. 예제 값: 34|
\| Cache-Control| string| 캐싱 동작을 지정하기 위해 서버가 보내는 요청입니다. 예: `no-cache, no-store`|

## 응답 본문

[PermissionCheckBatchResponse (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-permissioncheckbatchresponse)를 참조하십시오.

### 샘플 응답

```cpp theme={null}
{
    "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"}
                    ]
                }
            ]
        }
    ]
}

```

## 함께 보기

##### 상위

[/users/{requestorId}/permission/validate](https://devdocs.xbox.com/ko/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidate)

[PermissionId 열거형](https://devdocs.xbox.com/ko/reference/live/rest/enums/privacy-enum-permissionid.md)


## Related topics

- [PermissionId Enumeration](https://devdocs.xbox.com/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Enumeração PermissionId](https://devdocs.xbox.com/pt-BR/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Enumeración PermissionId](https://devdocs.xbox.com/es/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Énumération PermissionId](https://devdocs.xbox.com/fr/reference/live/rest/enums/privacy-enum-permissionid.md)
- [PermissionId 枚举](https://devdocs.xbox.com/zh-CN/reference/live/rest/enums/privacy-enum-permissionid.md)