POST(/users/xuid({xuid})/devices/current/titles/current)

사용자의 프레즌스로 타이틀을 업데이트합니다. 이 URI의 도메인은 userpresence.xboxlive.com입니다.

설명

이 URI는 콘솔 플랫폼이 아닌 플랫폼의 모든 타이틀에서 프레즌스, 리치 프레즌스 및 미디어 프레즌스 데이터를 추가 및 업데이트하는 데 사용할 수 있습니다.

SandboxId는 이제 XToken의 클레임에서 검색되고 적용됩니다. SandboxId가 없는 경우 엔터테인먼트 검색 서비스(EDS)에서 400 잘못된 요청 오류가 발생합니다.

매개 변수	형식	설명
xuid	64비트 부호 없는 정수	대상 사용자의 Xbox 사용자 ID(XUID).

유형	필수	설명	누락된 경우 응답
XUID	예	호출자의 Xbox 사용자 ID(XUID)	403 Forbidden
titleId	예	타이틀의 titleId	403 Forbidden
deviceId	예(Windows 및 웹을 제외한 모든 사용자의 경우)	호출자의 deviceId	403 Forbidden
deviceType	예(웹을 제외한 모든 사용자의 경우)	호출자의 deviceType	403 Forbidden
sandboxId	예(수신 호출의 경우)	호출자의 샌드박스	403 Forbidden

헤더	유형	설명
Authorization	문자열	HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: "XBL3.0 x=<userhash>;<token>".
x-xbl-contract-version	문자열	이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값: 3, vnext.
콘텐츠-종류	문자열	요청 본문의 mime 유형입니다. 예제 값은 application/json입니다.
Content-Length	문자열	요청 본문의 길이입니다. 예제 값: 312.
Host	문자열	서버의 도메인 이름입니다. 예제 값: presencebeta.xboxlive.com.

헤더	유형	설명
X-RequestedServiceVersion		이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.

요청 개체는 TitleRequest입니다. 본문에 실제로 있는 속성만 업데이트됩니다. 본문에 속하지 않지만 서버에 있는 모든 속성은 수정되지 않습니다.

{
  id:"12341234",
  placement:"snapped",
  state:"active"
}

성공하는 경우 HTTP 상태 코드 200 또는 201 Created가 적절히 반환됩니다.

오류(HTTP 4xx 또는 5xx)가 발생하는 경우 적절한 오류 정보가 응답 본문에 반환됩니다.