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