GET (/users/{userId}/profile/settings/people/{userList})
피플 모니커 지원을 통해 사용자 프로필을 가져옵니다.
이 URI의 도메인은 profile.xboxlive.com입니다.
설명
userList 및 userIds는 상호배타적인 매개 변수입니다. 둘 다 또는 하나만 지정되는 경우 BadRequest가 다시 나타납니다. userList는 여러 개의 명명된 목록이 유용한 요청 시나리오에서 향후 검증을 위한 배열입니다. userIds는 XUID용 10진수 문자열로 구성됩니다. JSON은 64비트 부호 없는 정수를 직렬화할 때 적절하지 않습니다. 마지막으로, Xbox One의 설정은 64비트 부호 없는 정수 또는 XONLINE_PROFILE_ASDF와 같은 모호한 상수 대신 사람이 읽을 수 있는 이름으로 설정됩니다.
URI 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| userId | 문자열 | 'xuid(12345)', 'gt(myGamertag)' 또는 'me'일 수 있습니다. |
| userList | 문자열 | 설정을 가져올 이름이 지정된 피플 목록입니다. 현재 피플 목록만 지원됩니다. |
쿼리 문자열 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 설정 | 문자열 | 쉼표로 구분된 설정 이름 목록입니다. |
필수 요청 헤더
| 헤더 | 유형 | 설명 |
|---|---|---|
| x-xbl-contract-version | 32비트 부호 있는 정수 | 값 = 2 |
| content-type | 문자열 | 값 = application/json |
요청 본문
샘플 요청
GET /users/me/profile/settings/people/people?settings=GameDisplayName,GameDisplayPicRaw,Gamerscore,Gamertag
응답 본문
응답은 ReadMultiSettingsResponseV2 개체입니다. 호출한 사용자에게 한 명의 친구만 있다고 가정합니다.
{
"profileUsers":[
{
"id":"2533274791381930",
"settings":[
{
"id":"GameDisplayName",
"value":"John Smith"
},
{
"id":"GameDisplayPicRaw",
"value":"http://images-eds.xboxlive.com/image?url=z951ykn43p4FqWbbFvR2Ec.8vbDhj8G2Xe7JngaTToBrrCmIEEXHC9UNrdJ6P7KIN0gxC2r1YECCd3mf2w1FDdmFCpSokJWa2z7xtVrlzOyVSc6pPRdWEXmYtpS2xE4F&format=png&w=64&h=64"
},
{
"id":"Gamerscore",
"value":"0"
},
{
"id":"Gamertag",
"value":"CracklierJewel9"
}
]
}
]
}
참고 항목
부모
/users/{userId}/profile/settings/people/{userList}?settings={settings}