Skip to main content

​
GET (/users/xuid()/history/titles)

사용자가 도전 과제를 잠금 해제했거나 진행 상황을 만든 타이틀 목록을 가져옵니다. 이 API는 사용자가 플레이했거나 실행한 타이틀의 전체 기록을 반환하지 않습니다. 이 URI의 도메인은 achievements.xboxlive.com입니다.

​
URI 매개 변수

​
쿼리 문자열 매개 변수

| 매개 변수| 필수| 유형| 설명| | --- | --- | --- | --- | --- | --- | --- | | skipItems| 아니요| 32-bit signed integer| 지정된 개수의 항목 이후부터 항목을 반환합니다. 예를 들어, skipItems=“3”은 검색된 네 번째 항목부터 시작하여 항목을 검색합니다. | | continuationToken| 아니요| string| 지정된 연속 토큰부터 시작하여 항목을 반환합니다. | | maxItems| 아니요| 32-bit signed integer| 컬렉션에서 반환할 최대 항목 수이며, skipItems 및 continuationToken과 결합하여 항목 범위를 반환할 수 있습니다. maxItems가 없으면 서비스가 기본값을 제공할 수 있으며, 결과의 마지막 페이지가 아직 반환되지 않은 경우에도 maxItems보다 적은 값을 반환할 수 있습니다. |

​
권한 부여

| 클레임| 필수 여부| 설명| 누락 시 동작| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | User| 호출자는 권한이 있는 XBOX LIVE 사용자입니다.| 호출자는 XBOX LIVE에서 유효한 사용자여야 합니다.| 403 Forbidden|

​
선택적 요청 헤더

| 헤더| 유형| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| string| 이 요청이 라우팅될 XBOX LIVE 서비스의 빌드 이름/번호입니다. 요청은 헤더, 인증 토큰의 클레임 등의 유효성을 확인한 후에만 해당 서비스로 라우팅됩니다.| | x-xbl-contract-version| 32-bit unsigned integer| 존재하고 2로 설정된 경우 이 API의 V2 버전이 사용됩니다. 그렇지 않으면 V1이 사용됩니다.|

​
요청 본문

이 요청의 본문에는 어떠한 개체도 전송되지 않습니다.

​
참고 항목

부모
/users/xuid()/history/titles
참조
UserTitle (JSON) PagingInfo (JSON) Paging Parameters
Last modified on October 19, 2026