메인 콘텐츠로 건너뛰기

​
POST (/users/xuid()/devices/current/titles/current)

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

​
설명

이 URI는 비콘솔 플랫폼의 모든 타이틀에서 타이틀에 대한 프레즌스, 리치 프레즌스 및 미디어 프레즌스 데이터를 추가하고 업데이트하는 데 사용할 수 있습니다. SandboxId는 이제 XToken의 클레임에서 검색되어 적용됩니다. SandboxId가 존재하지 않는 경우 Entertainment Discovery Services(EDS)는 400 Bad request 오류를 발생시킵니다.

​
URI 매개 변수

​
권한 부여

| 형식| 필수| 설명| 누락 시 응답| | --- | --- | --- | --- | --- | --- | --- | | XUID| 예| 호출자의 XBOX User ID(XUID)| 403 Forbidden| | titleId| 예| 타이틀의 titleId| 403 Forbidden| | deviceId| Windows 및 Web을 제외한 모두에서 필수| 호출자의 deviceId| 403 Forbidden| | deviceType| Web을 제외한 모두에서 필수| 호출자의 deviceType| 403 Forbidden| | sandboxId| 다음에서 오는 호출에 필수 | 호출자의 sandbox| 403 Forbidden|

​
필수 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 인증을 위한 인증 자격 증명입니다. 예시 값: “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 예시 값: 3, vnext.| | Content-Type| string| 요청 본문의 MIME 형식입니다. 예시 값: application/json.| | Content-Length| string| 요청 본문의 길이입니다. 예시 값: 312.| | Host| string| 서버의 도메인 이름입니다. 예시 값: presencebeta.xboxlive.com.|

​
선택적 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.|

​
요청 본문

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

​
샘플 요청

​
응답 본문

성공하면 상황에 따라 HTTP 상태 코드 200 또는 201 Created가 반환됩니다. 오류(HTTP 4xx 또는 5xx)의 경우 적절한 오류 정보가 응답 본문에 반환됩니다.

​
참고 항목

상위
/users/xuid()/devices/current/titles/current
추가 정보
Marketplace URIs Additional Reference
마지막 수정일 2026년 10월 19일