다음을 통해 공유

GET (/users/{requestorId}/permission/validate)

  • 아티클

사용자가 대상 사용자와 함께 지정된 작업을 수행할 수 있는지 여부에 대한 예 또는 아니요 대답을 가져옵니다.

URI 매개 변수

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

쿼리 문자열 매개 변수

매개 변수 형식 설명
설정 문자열 열거형 각각 확인할 PermissionId 값. 예제 값: "CommunicateUsingText".
target 문자열 작업이 수행될 사용자의 ID입니다. 가능한 값은 xuid({xuid})입니다. 예제 값: xuid(0987654321)

Authorization

사용된 권한 부여 클레임 클레임 유형 필수? 예제 값
Xuid 64비트 부호 있는 정수 예 1234567890

필수 요청 헤더

헤더 유형 설명
Authorization 문자열 HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: XBL3.0 x=<userhash>;<token>
X-RequestedServiceVersion 문자열 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값은 1입니다.

요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

HTTP 상태 코드

서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.

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

필수 응답 헤더

헤더 유형 설명
콘텐츠-종류 문자열 요청 본문의 MIME 유형입니다. 예제 값: application/json
Content-Length 문자열 응답에서 전송되는 바이트 수입니다. 예제 값: 34
Cache-Control 문자열 캐싱 동작을 지정하는 서버의 형식적인 요청입니다. 예: no-cache, no-store

응답 본문

PermissionCheckResponse(JSON)를 참조하세요.

샘플 응답

{
    "isAllowed": false,
    "reasons":
    [
        {"reason": "BlockedByRequestor"},
        {"reason": "MissingPrivilege", "restrictedSetting": "VideoCommunications"}
    ]
}

참고 항목

부모

/users/{requestorId}/permission/validate

PermissionId 열거형