GET(/users/{ownerId}/people/mute)
사용자의 음소거 목록을 가져옵니다.
설명
대상이 지정되는 경우 이 URI는 사용자가 음소거 목록에 있으면 해당 사용자만 반환하며 그렇지 않은 경우에는 비어 있습니다.
URI 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| ownerId | 문자열 | 필수. 리소스에 액세스하는 사용자의 식별자입니다. 가능한 값은 "me", xuid({xuid}) 또는 gt({gamertag})입니다. 인증된 사용자여야 합니다. 예제 값: xuid(2603643534573581), gt(SomeGamertag). 최대 크기: 없음. |
리소스에 대한 개인 정보 설정의 영향
없음.
권한 부여
| 사용된 권한 부여 클레임 | 클레임 | 유형 | 필수? | 예제 값 |
|---|---|---|---|---|
| Xuid | 64비트 부호 있는 정수 | 예 | 1234567890 |
필수 요청 헤더
| 헤더 | 유형 | 설명 |
|---|---|---|
| Authorization | 문자열 | HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: Xauth=<authtoken>. 최대 크기: 없음. |
| X-RequestedServiceVersion | 문자열 | 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값: 1, vnext. 최대 크기: 없음. |
| 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 | 문자열 | 캐싱 동작을 지정하는 서버의 형식적인 요청입니다. 예: no-cache, no-store |
응답 본문
샘플 응답
UserList를 참조하세요.
{
"users":
[
{ "xuid":"12345" },
{ "xuid":"23456" }
]
}