Skip to main content

GET (/users//profile/settings/people/)

People 모니커를 지원하는 사용자 또는 사용자들의 프로필을 가져옵니다. 이러한 URI의 도메인은 profile.xboxlive.com입니다.

설명

userList와 userIds는 상호 배타적인 매개 변수입니다. 둘 다 또는 둘 중 하나라도 지정하면 BadRequest를 반환합니다. userList는 여러 명명된 목록을 요청하는 것이 유용한 시나리오를 위한 미래 대비용 배열입니다. userIds는 XUID에 대한 10진수 문자열로 구성됩니다 - JSON은 64비트 부호 없는 정수의 직렬화에 적합하지 않습니다. 마지막으로 XBOX One의 설정은 64비트 부호 없는 정수나 XONLINE_PROFILE_ASDF 같은 불명확한 상수가 아니라, 사람이 읽을 수 있는 일반적인 이름의 명명된 설정이 됩니다.

URI 매개 변수

쿼리 문자열 매개 변수

| 매개 변수| 형식| 설명| | --- | --- | --- | --- | --- | --- | | settings| string| 설정 이름의 쉼표로 구분된 목록입니다.|

필수 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 32비트 부호 있는 정수| 값 = 2| | content-type| string| 값 = application/json|

요청 본문

샘플 요청

응답 본문
응답은 ReadMultiSettingsResponseV2 개체입니다. 호출하는 사용자에게 친구가 한 명만 있다고 가정합니다.

함께 보기

상위
/users//profile/settings/people/?settings= Profile (JSON)
Last modified on October 19, 2026