Post Recent Players

사용자의 최근 플레이어 목록에 추가하거나 업데이트합니다(단방향). 이 API를 통해 게임 클라이언트는 사용자의 최근 플레이어 목록에 추가하고 기존 최근 플레이어 항목을 업데이트할 수 있습니다. 이 호출은 호출자의 최근 플레이어 목록에만 영향을 미칩니다(단방향).

POST /titles/{titleId}/recentplayers

URI 매개 변수

매개 변수	위치	필수	형식	설명
titleId	path	TRUE	integer	요청이 전송되는 게임의 titleId입니다.

요청 헤더

이름	필수	형식	설명
Authorization	TRUE	integer	호출자는 XBL 3.0 권한 부여 형식으로 XToken을 제공해야 합니다. 예: Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type	TRUE	string	ContentType은 application/json으로 설정해야 합니다.

요청 본문

이름	필수	형식	설명
recentPlayers	TRUE		이 사용자에 대한 최근 플레이어 배열입니다. 최소 1명, 최대 100명의 최근 플레이어가 있어야 합니다.

응답

이름	형식	설명
204 No Content		최근 플레이어 요청이 성공적으로 전송되었습니다.
400 Bad Request	ErrorResponse	요청 처리 중에 오류가 발생했습니다. 가능한 오류 코드: “RequestValidationError: The request validation has failed.”, “ AuthorizationError: The caller is not allowed to access the resource.”
Other Status Codes	ThrottledEntity	너무 많은 요청. Headers Retry-After: integer

ClientRecentPlayersRequest

이름	형식	설명
recentPlayers		이 사용자에 대한 최근 플레이어 배열입니다. 최소 1명, 최대 100명의 최근 플레이어가 있어야 합니다.

EncounterType

최근 플레이어 만남의 유형입니다. 이 필드는 선택 사항이며 기본값은 Default입니다. Default에는 정해진 의미가 없으며, 이 값을 적절하게 해석하는 것은 호출자의 몫입니다.

이름	형식	설명
Default	string
Opponent	string
Teammate	string

ErrorResponse

이름	형식	설명
debugMessage	string	디버깅에 사용할 수 있는 사람이 읽을 수 있는 형태의 오류 메시지입니다.
errorCode	string	오류 코드 열거형입니다.

Network

이름	형식	설명
XboxLive	string

ThrottledEntity

이름	형식	설명
currentRequests	string	현재 요청 수 - 동시성 또는 요청률입니다.
debugMessage	string	디버깅에 사용할 수 있는 사람이 읽을 수 있는 형태의 스로틀 메시지입니다.
limitType	string	제한 형식으로, 동시성 또는 요청률입니다.
maxRequests	string	허용되는 최대 요청 수 - 동시성 또는 요청률입니다.
periodInSeconds	string	요청률 또는 동시성 제한이 초과될 때 적용되는 기간(초 단위)입니다.
version	string	현재 스로틀 계약 버전입니다.

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

POST /titles/{titleId}/recentplayers

Post Recent Players

URI 매개 변수

요청 헤더

요청 본문

응답

정의

ClientRecentPlayersRequest

EncounterType

ErrorResponse

Network

ThrottledEntity

​Post Recent Players

​URI 매개 변수

​요청 헤더

​요청 본문

​응답

​정의

​ClientRecentPlayersRequest

​EncounterType

​ErrorResponse

​Network

​ThrottledEntity

Post Recent Players

URI 매개 변수

요청 헤더

요청 본문

응답

정의

ClientRecentPlayersRequest

EncounterType

ErrorResponse

Network

ThrottledEntity