> ## 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/{scid}/{achievementid})

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

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

업적의 세부 정보를 가져옵니다.
이 URI의 도메인은 `achievements.xboxlive.com`입니다.

* [URI 매개변수](#ID4EV)
* [권한 부여](#ID4EAB)
* [개인정보 설정이 리소스에 미치는 영향](#ID4E4C)
* [필수 요청 헤더](#ID4EPG)
* [선택적 요청 헤더](#ID4EPH)
* [요청 본문](#ID4ECBAC)
* [HTTP 상태 코드](#ID4ENBAC)
* [응답 본문](#ID4EBGAC)

## URI 매개변수

| 매개변수 | 형식 | 설명 |
| - | - | - |
| xuid | 64비트 부호 없는 정수 | 리소스에 액세스하려는 사용자의 XBOX 사용자 ID(XUID)입니다. 인증된 사용자의 XUID와 일치해야 합니다. |
| scid | GUID | 업적에 액세스하려는 서비스 구성의 고유 식별자입니다. |
| achievementid | 32비트 부호 없는 정수 | 액세스하려는 업적의 (지정된 SCID 내에서의) 고유 식별자입니다. |

## 권한 부여

사용되는 권한 부여 클레임 | 클레임| 필수 여부| 설명| 누락된 경우 동작|
\| --- | --- | --- | --- | --- | --- | --- |
\| User| 예| 요청이 이루어지는 대상인 XBOX LIVE의 유효한 사용자입니다.| 403 Forbidden|
\| Title| 아니요| 호출하는 타이틀입니다.| AuthZ에 따라 달라집니다. 2013년 5월 1일 기준, AuthZ는 누락 시 클레임을 제공하지 않으므로 공개로 표시되지 않은 SCID에 대한 액세스를 거부합니다.|
\| Sandbox| 아니요| 결과를 검색해야 하는 샌드박스입니다.| AuthZ에 따라 달라집니다. 2013년 5월 1일 기준, AuthZ는 누락 시 기본 클레임을 제공하지 않습니다.|

## 개인정보 설정이 리소스에 미치는 영향

개인정보 설정이 리소스에 미치는 영향 | 요청하는 사용자| 대상 사용자의 개인정보 설정| 동작|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| me| -| 설명된 대로.|
\| friend| everyone| OK|
\| friend| friends only| OK|
\| friend| blocked| Forbidden.|
\| non-friend user| everyone| OK|
\| non-friend user| friends only| Forbidden.|
\| non-friend user| blocked| Forbidden.|
\| third-party site| everyone| OK|
\| third-party site| friends only| Forbidden.|
\| third-party site| blocked| Forbidden.|

## 필수 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: "XBL3.0 x=\<userhash>;\<token>".|

## 선택적 요청 헤더

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

## 요청 본문

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

## HTTP 상태 코드

이 리소스에서 이 메서드로 이루어진 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 [표준 HTTP 상태 코드](https://devdocs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes)를 참조하세요.

\| 코드| 이유 구문| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 세션을 성공적으로 검색했습니다.|
\| 301| Moved Permanently| 서비스가 다른 URI로 이동했습니다.|
\| 307| Temporary Redirect| 이 리소스의 URI가 일시적으로 변경되었습니다.|
\| 400| Bad Request| 서비스가 잘못된 형식의 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개변수입니다.|
\| 401| Unauthorized| 요청에 사용자 인증이 필요합니다.|
\| 403| Forbidden| 사용자 또는 서비스에 대한 요청이 허용되지 않습니다.|
\| 404| Not Found| 지정된 리소스를 찾을 수 없습니다.|
\| 406| Not Acceptable| 리소스 버전이 지원되지 않습니다. MVC 계층에서 거부해야 합니다.|
\| 408| Request Timeout| 요청이 완료되는 데 너무 오래 걸렸습니다.|
\| 410| Gone| 요청된 리소스를 더 이상 사용할 수 없습니다.|

## 응답 본문

### 샘플 응답

```cpp theme={null}
{
    "achievement":
    {
        "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":
        {
                "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
    }
}
         
```

## 참고 항목

##### 상위 항목

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


## 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)
