리소스가 액세스되는 사용자의 Xbox 사용자 ID(XUID)입니다. 인증된 사용자의 XUID와 일치해야 합니다.
scid
GUID
도전 과제에 액세스 중인 서비스 구성의 고유 식별자입니다.
achievementid
32비트 부호 없는 정수
액세스 중인 도전 과제의 고유(지정된 SCID 내) 식별자입니다.
Authorization
사용된 권한 부여 클레임
클레임
필수?
설명
누락된 경우의 동작
사용자
예
요청이 이루어진 Xbox LIVE의 유효한 사용자입니다.
403 Forbidden
타이틀
아니요
호출되는 타이틀입니다.
AuthZ에 따라 다릅니다. 2013년 5월 1일부터 AuthZ는 누락된 경우 클레임을 제공하지 않으며, 이에 따라 공개되지 않은 SCID에 대한 액세스를 거부합니다.
샌드박스
아니요
결과를 검색해야 할 샌드박스입니다.
AuthZ에 따라 다릅니다. 2013년 5월 1일부터 AuthZ는 누락된 경우 기본 클레임을 제공하지 않습니다.
리소스에 대한 개인 정보 설정의 영향
리소스에 대한 개인 정보 설정의 영향
요청 사용자
대상 사용자의 개인 정보 설정
동작
나
-
설명과 같습니다.
친구
모두
OK
친구
친구만
OK
친구
차단
금지됩니다.
친구가 아닌 사용자
모두
OK
친구가 아닌 사용자
친구만
금지됩니다.
친구가 아닌 사용자
차단
금지됩니다.
타사 사이트
모두
OK
타사 사이트
친구만
금지됩니다.
타사 사이트
차단
금지됩니다.
필수 요청 헤더
헤더
유형
설명
Authorization
문자열
HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: "XBL3.0 x=<userhash>;<token>".
선택적 요청 헤더
헤더
유형
설명
X-RequestedServiceVersion
문자열
이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.
x-xbl-contract-version
문자열
기본값은 V1입니다.
Accept-Language
문자열
원하는 지역/국가 및 대체 언어의 목록입니다(예: fr-FR, fr, en-GB, en-WW, en-US). 도전 과제 서비스는 일치하는 현지화 문자열을 찾을 때까지 목록을 탐색합니다. 아무것도 찾지 못하면 사용자의 IP 주소에서 얻은 사용자 토큰에 정의된 위치를 매칭하려고 시도합니다. 그래도 일치하는 현지화 문자열이 발견되지 않으면 타이틀 개발자/퍼블리셔가 제공하는 기본 문자열을 사용합니다.
요청 본문
이 요청의 본문에는 개체가 전송되지 않습니다.
HTTP 상태 코드
서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.
코드
이유 구문
설명
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
요청된 리소스를 더 이상 사용할 수 없습니다.
응답 본문
샘플 응답
{
"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
}
}