메인 콘텐츠로 건너뛰기

GET (/users/{ownerId}/people)

호출자의 people 컬렉션을 가져옵니다. 이러한 URI의 도메인은 social.xboxlive.com입니다.

설명

GET 작업은 리소스를 수정하지 않으므로, 한 번 실행하든 여러 번 실행하든 동일한 결과를 생성합니다.

URI 매개 변수

쿼리 문자열 매개 변수

권한 부여

필수 요청 헤더

선택적 요청 헤더

요청 본문

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

HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 Standard HTTP status codes를 참고하십시오.

필수 응답 헤더

응답 본문

호출이 성공하면 서비스는 호출자의 people 컬렉션에 있는 총 사람 수와 호출자의 people 컬렉션을 포함하는 배열을 반환합니다. PeopleList (JSON)를 참고하십시오.

샘플 응답

참고 항목

/users/{ownerId}/people
마지막 수정일 2026년 11월 5일