Skip to main content

GET (/users/xuid()/achievements)

타이틀에 정의된 업적 목록, 사용자가 잠금 해제한 업적 목록 또는 사용자가 진행 중인 업적 목록을 가져옵니다. 이러한 URI의 도메인은 achievements.xboxlive.com입니다.

URI 매개 변수

쿼리 문자열 매개 변수

| 매개 변수| 필수 여부| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | | skipItems| 아니요| 32비트 부호 있는 정수| 지정된 항목 수 이후부터 항목을 반환합니다. 예를 들어 skipItems=“3”은 네 번째 항목부터 검색합니다. | | continuationToken| 아니요| string| 지정된 연속 토큰에서부터 항목을 반환합니다. | | maxItems| 아니요| 32비트 부호 있는 정수| 컬렉션에서 반환할 최대 항목 수이며, skipItems 및 continuationToken과 조합하여 항목의 범위를 반환할 수 있습니다. maxItems가 없으면 서비스가 기본값을 제공할 수 있으며, 결과의 마지막 페이지가 아직 반환되지 않았더라도 maxItems보다 적게 반환할 수 있습니다. | | titleId| 아니요| string| 반환된 결과에 대한 필터입니다. 하나 이상의 쉼표로 구분된 십진수 타이틀 식별자를 허용합니다.| | unlockedOnly| 아니요| 부울 값| 반환된 결과에 대한 필터입니다. true로 설정하면 사용자에 대해 잠금 해제된 업적만 반환합니다. 기본값은 false입니다.| | possibleOnly| 아니요| 부울 값| 반환된 결과에 대한 필터입니다. true로 설정하면 잠금 해제된 메타데이터가 아닌 XMS의 업적 정보만 포함하여 가능한 모든 결과를 반환합니다. 기본값은 false입니다.| | types| 아니요| string| 반환된 결과에 대한 필터입니다. “Persistent” 또는 “Challenge”일 수 있습니다. 기본값은 지원되는 모든 유형입니다.| | orderBy| 아니요| string| 결과를 반환할 순서를 지정합니다. “Unordered”, “Title”, “UnlockTime” 또는 “EndingSoon”일 수 있습니다. 기본값은 “Unordered”입니다.|

권한 부여

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

필수 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 인증에 대한 인증 자격 증명입니다. 예시 값: “XBL3.0 x=<userhash>;<token>”.|

선택적 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| string| 이 요청이 전달되어야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 요청은 헤더의 유효성, 인증 토큰의 클레임 등을 확인한 후에만 해당 서비스로 라우팅됩니다. 기본값: 1.| | x-xbl-contract-version| 32비트 부호 없는 정수| 있고 2로 설정된 경우 이 API의 V2 버전이 사용됩니다. 그렇지 않으면 V1이 사용됩니다.| | Accept-Language| string| 원하는 로캘 및 대체 로캘 목록입니다(예: fr-FR, fr, en-GB, en-WW, en-US). Achievements 서비스는 일치하는 지역화 문자열을 찾을 때까지 목록을 순차적으로 처리합니다. 어떤 것도 찾을 수 없는 경우 사용자의 IP 주소에서 오는 사용자 토큰에 정의된 위치와 일치시키려고 시도합니다. 여전히 일치하는 지역화 문자열을 찾을 수 없는 경우 타이틀 개발자/게시자가 제공한 기본 문자열을 사용합니다. |

요청 본문

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

응답 본문

호출이 성공하면 서비스는 Achievement (JSON) 개체의 배열과 PagingInfo (JSON) 개체를 반환합니다.

샘플 응답

함께 보기

상위
/users/xuid()/achievements
참조
Achievement (JSON) PagingInfo (JSON) 페이징 매개 변수
Last modified on October 19, 2026