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

# POST (/users/xuid({xuid})/achievements/{scid}/update)

> POST (/users/xuid({xuid})/achievements/{scid}/update)

# POST (/users/xuid({xuid})/achievements/{scid}/update)

업적의 진행 상황을 업데이트합니다.
이 URI의 도메인은 `achievements.xboxlive.com`입니다.

* [URI 매개변수](#ID4EV)
* [권한 부여](#ID4EAB)
* [필수 요청 헤더](#ID4EPG)
* [선택적 요청 헤더](#ID4EPH)
* [요청 본문](#ID4ECBAC)
* [HTTP 상태 코드](#ID4ENBAC)
* [응답 본문](#ID4EBGAC)

## 설명

* 호출이 성공하면 빈 응답 본문과 함께 HTTP 상태 코드 200이 반환됩니다.
* 호출 결과로 업적 진행 상황에 변화가 없는 경우(즉, 이미 잠금 해제되었거나 완료율이 동일한 경우), 빈 응답 본문과 함께 HTTP 상태 코드 304가 반환됩니다.

## URI 매개변수

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

## 권한 부여

| 클레임 | 필수 여부 | 설명 | 누락된 경우 동작 |
| - | - | - | - |
| User | 예 | 요청이 이루어지는 대상인 XBOX LIVE의 유효한 사용자입니다. | 403 Forbidden |

## 필수 요청 헤더

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

## 선택적 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Accept-Language| string| 원하는 로캘 및 대체 항목 목록입니다(예: fr-FR, fr, en-GB, en-WW, en-US). Achievements 서비스는 일치하는 지역화 문자열을 찾을 때까지 목록을 순회합니다. 찾을 수 없으면 사용자 IP 주소에서 얻은 사용자 토큰에 정의된 위치와 일치를 시도합니다. 그래도 일치하는 지역화 문자열이 없으면 타이틀 개발자/게시자가 제공한 기본 문자열을 사용합니다. |

## 요청 본문

[AchievementUpdateRequest (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-achievementupdaterequest.md) 개체입니다.

### 샘플 요청

`POST /users/xuid({2810000000000000})/achievements/{00000000-0000-0000-0000-000000000000}/update`

```json theme={null}
{
    "action": "progressUpdate",
    "serviceConfigId": "00000000-0000-0000-0000-000000000000",
    "titleId": 0000000000,
    "userId": "2810000000000000",
    "achievements": [
        {
            "id": "1",
            "percentComplete": 100
        }
    ]
}
```

## HTTP 상태 코드

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

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

## 응답 본문

응답 본문은 비어 있습니다.

## 참고 항목

##### 상위 항목

[/users/xuid({xuid})/achievements/{scid}/update](https://docs.xbox.com/ko/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)


## Related topics

- [/users/xuid({xuid})/achievements/{scid}/update](https://docs.xbox.com/ko/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)
- [/users/xuid({xuid})/achievements/{scid}/{achievementid}](https://docs.xbox.com/ko/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid.md)
- [GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})](https://docs.xbox.com/ko/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementidget.md)
- [/users/xuid({xuid})/achievements](https://docs.xbox.com/ko/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsv2.md)
- [GET (/users/xuid({xuid})/achievements)](https://docs.xbox.com/ko/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsgetv2.md)