> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/xuid({xuid})/achievements)

> GET (/users/xuid({xuid})/achievements)

# GET (/users/xuid({xuid})/achievements)

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

* [URI 매개 변수](#ID4EX)
* [쿼리 문자열 매개 변수](#ID4ECB)
* [권한 부여](#ID4ENF)
* [필수 요청 헤더](#ID4ESG)
* [선택적 요청 헤더](#ID4ESH)
* [요청 본문](#ID4EIBAC)
* [응답 본문](#ID4ETBAC)

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| xuid | 64비트 부호 없는 정수 | 액세스되는 (리소스의) 사용자의 XBOX 사용자 ID(XUID)입니다. 인증된 사용자의 XUID와 일치해야 합니다. |

## 쿼리 문자열 매개 변수

\| 매개 변수| 필수 여부| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- |
\| **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)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-achievementv2) 개체의 배열과 [PagingInfo (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-paginginfo) 개체를 반환합니다.

### 샘플 응답

```cpp theme={null}
{
    "achievements":
    [{
        "id":"3",
        "serviceConfigId":"b5dd9daf-0000-0000-0000-000000000000",
        "name":"Default NameString for Microsoft Achievements Sample Achievement 3",
        "titleAssociations":
        [{
                "name":"Microsoft Achievements Sample",
                "id":3051199919,
                "version":"abc"
        }],
        "progressState":"Achieved",
        "progression":
        {
                "achievementState":"Achieved",
                "requirements":null,
                "timeUnlocked":"2013-01-17T03:19:00.3087016Z",
        },
        "mediaAssets":
        [{
                "name":"Icon Name",
                "type":"Icon",
                "url":"http://www.xbox.com"
        }],
        "platform":"D",
        "isSecret":true,
        "description":"Default DescriptionString for Microsoft Achievements Sample Achievement 3",
        "lockedDescription":"Default UnachievedString for Microsoft Achievements Sample Achievement 3",
        "productId":"12345678-1234-1234-1234-123456789012",
        "achievementType":"Challenge",
        "participationType":"Individual",
        "timeWindow":
        {
                "startDate":"2013-02-01T00:00:00Z",
                "endDate":"2100-07-01T00:00:00Z"
        },
        "rewards":
        [{
                "name":null,
                "description":null,
                "value":"10",
                "type":"Gamerscore",
                "valueType":"Int"
        },
        {
                "name":"Default Name for InAppReward for Microsoft Achievements Sample Achievement 3",
                "description":"Default Description for InAppReward for Microsoft Achievements Sample Achievement 3",
                "value":"1",
                "type":"InApp",
                "valueType":"String"
        }],
        "estimatedTime":"06:12:14",
        "deeplink":"aWFtYWRlZXBsaW5r",
        "isRevoked":false
        }],
        "pagingInfo":
        {
                "continuationToken":null,
                "totalRecords":1
        }
}
         
```

## 함께 보기

##### 상위

[/users/xuid({xuid})/achievements](https://devdocs.xbox.com/ko/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsv2)

##### 참조

[Achievement (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-achievementv2)

[PagingInfo (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-paginginfo)

[페이징 매개 변수](https://devdocs.xbox.com/ko/reference/live/rest/additional/pagingparameters)


## Related topics

- [XblAchievementsGetAchievementAsync](https://devdocs.xbox.com/fr/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](https://devdocs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)