다음을 통해 공유


GET(/users/{ownerId}/people/avoid)

사용자의 회피 목록을 가져옵니다.

설명

대상이 지정되는 경우 사용자가 차단 목록에 있으면 해당 사용자만 반환하며 그렇지 않은 경우에는 비어 있습니다.

URI 매개 변수

매개 변수 형식 설명
ownerId 문자열 필수. 리소스에 액세스하는 사용자의 식별자입니다. 가능한 값은 xuid({xuid})입니다. 인증된 사용자여야 합니다. 예제 값: xuid(2603643534573581). 최대 크기: 없음.

권한 부여

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

필수 요청 헤더

헤더 유형 설명
Authorization 문자열 HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: Xauth=<authtoken>. 최대 크기: 없음.
Accept 문자열 허용 가능한 콘텐츠-유형입니다. 예제 값: application/json. 최대 크기: 없음.

HTTP 상태 코드

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

코드 이유 구문 설명
200 OK 세션이 성공적으로 검색되었습니다.
400 Bad Request URI에 지정된 대상 ID가 유효하지 않습니다.
403 Forbidden URI에 지정된 소유자는 인증된 사용자가 아닙니다.
404 Not Found URI에 지정된 소유자가 존재하지 않습니다.

필수 응답 헤더

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

응답 본문

샘플 응답

{
    "users":
    [
        { "xuid":"12345" },
        { "xuid":"23456" }
    ]
}

참고 항목

부모

/users/{ownerId}/people/avoid