다음을 통해 공유

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

  • 아티클

도전 과제의 진행률을 업데이트합니다. 이 URI의 도메인은 achievements.xboxlive.com입니다.

설명

  • 성공적인 호출은 빈 응답 본문이 있는 200의 HTTP 상태 코드를 반환합니다.
  • 호출로 인해 도전 과제 진행률이 변경되지 않는 경우(즉, 이미 잠금 해제되었거나 동일한 완료율로) 호출은 빈 응답 본문이 있는 HTTP 상태 코드 304를 반환합니다.

URI 매개 변수

매개 변수 형식 설명
xuid 64비트 부호 없는 정수 리소스가 액세스되는 사용자의 Xbox 사용자 ID(XUID)입니다. 인증된 사용자의 XUID와 일치해야 합니다.
scid GUID 도전 과제에 액세스 중인 서비스 구성의 고유 식별자입니다.

Authorization

클레임 필수? 설명 누락된 경우의 동작
사용자 예 요청이 이루어진 Xbox LIVE의 유효한 사용자입니다. 403 Forbidden

필수 요청 헤더

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

선택적 요청 헤더

헤더 형식 설명
Accept-Language 문자열 원하는 지역/국가 및 대체 언어의 목록입니다(예: fr-FR, fr, en-GB, en-WW, en-US). 도전 과제 서비스는 일치하는 현지화 문자열을 찾을 때까지 목록을 탐색합니다. 아무것도 찾지 못하면 사용자의 IP 주소에서 얻은 사용자 토큰에 정의된 위치를 매칭하려고 시도합니다. 그래도 일치하는 현지화 문자열이 발견되지 않으면 타이틀 개발자/퍼블리셔가 제공하는 기본 문자열을 사용합니다.

요청 본문

AchievementUpdateRequest(JSON) 개체입니다.

샘플 요청

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

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

HTTP 상태 코드

서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 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({xuid})/achievements/{scid}/update