다음을 통해 공유

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

  • 아티클

타이틀에 정의된 도전 과제나 사용자가 잠금을 해제했거나 사용자가 진행 중인 도전 과제의 목록을 가져옵니다. 이 URI의 도메인은 achievements.xboxlive.com입니다.

URI 매개 변수

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

쿼리 문자열 매개 변수

매개 변수 필수 유형 설명
skipItems 아니요 32비트 부호 있는 정수 특정 항목 수 다음에 시작하는 항목을 반환합니다. 예를 들어 skipItems="3"은 검색된 네 번째 항목으로 시작하는 항목을 검색합니다.
continuationToken 아니요 문자열 특정 연속 토큰에서 시작하는 항목을 반환합니다.
maxItems 아니요 32비트 부호 있는 정수 컬렉션에서 반환할 최대 항목 수이며 skipItems 및 continuationToken과 결합하여 항목 범위를 반환할 수 있습니다. maxItems가 없으면 서비스가 기본값을 제공할 수 있으며 결과의 마지막 페이지가 아직 반환되지 않은 경우에도 maxItems보다 작은 값을 반환할 수 있습니다.
titleId 아니요 문자열 반환되는 결과를 위한 필터입니다. 쉼표로 구분된 하나 이상의 10진수 타이틀 식별자를 허용합니다.
unlockedOnly 아니요 부울 값 반환되는 결과를 위한 필터입니다. true로 설정할 경우 사용자에게 잠금 해제된 도전 과제만 반환합니다. 기본값은 false입니다.
possibleOnly 아니요 부울 값 반환되는 결과를 위한 필터입니다. true로 설정할 경우 잠금 해제된 메타 데이터를 제외한 모든 가능한 결과를 반환하는데, 여기에는 XMS의 도전 과제 정보만 해당됩니다. 기본값은 false입니다.
types 아니요 문자열 반환되는 결과를 위한 필터입니다. "Persistent" 또는 "Challenge"로 설정할 수 있습니다. 기본값은 지원되는 모든 유형입니다.
orderBy 아니요 문자열 결과가 반환되는 순서를 지정합니다. "Unordered", "Title", "UnlockTime", "EndingSoon"으로 설정할 수 있습니다. 기본값은 "Unordered"입니다.

Authorization

클레임 필수? 설명 누락된 경우의 동작
사용자 호출자는 권한이 부여된 Xbox LIVE 사용자입니다. 호출자는 Xbox LIVE에서 유효한 사용자여야 합니다. 403 Forbidden

필수 요청 헤더

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

선택적 요청 헤더

헤더 유형 설명
X-RequestedServiceVersion 문자열 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 기본 값은 1입니다.
x-xbl-contract-version 32비트 부호 없는 정수 이 값이 2로 설정되어 있는 경우 이 API의 V2 버전이 사용됩니다. 그렇지 않으면 V1이 사용됩니다.
Accept-Language 문자열 원하는 지역/국가 및 대체 언어의 목록입니다(예: fr-FR, fr, en-GB, en-WW, en-US). 도전 과제 서비스는 일치하는 현지화 문자열을 찾을 때까지 목록을 탐색합니다. 아무것도 찾지 못하면 사용자의 IP 주소에서 얻은 사용자 토큰에 정의된 위치를 매칭하려고 시도합니다. 그래도 일치하는 현지화 문자열이 발견되지 않으면 타이틀 개발자/퍼블리셔가 제공하는 기본 문자열을 사용합니다.

요청 본문

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

응답 본문

호출이 성공하면 서비스가 Achievement (JSON) 개체와 PagingInfo (JSON) 개체의 배열을 반환합니다.

샘플 응답

{
    "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

참조

Achievement(JSON)

PagingInfo(JSON)

페이징 매개 변수