메인 콘텐츠로 건너뛰기

POST (/users/xuid()/achievements//update)

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

설명

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

URI 매개변수

권한 부여

필수 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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) 개체입니다.

샘플 요청

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

HTTP 상태 코드

이 리소스에서 이 메서드로 이루어진 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요. | 코드| 이유 구문| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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()/achievements//update
마지막 수정일 2026년 10월 19일