Post Server Recent Players

여러 사용자의 최근 플레이어 목록에 추가하거나 업데이트합니다(단방향). 이는 본질적으로 서버를 위한 클라이언트 API의 배치 API입니다. 이 API를 통해 게임 서버는 여러 사용자의 최근 플레이어 목록에 추가하고 기존 최근 플레이어 항목을 업데이트할 수 있습니다. 각 사용자의 최근 플레이어 목록은 단방향입니다.

POST /titles/{titleId}/recentplayers/server

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으로 설정해야 합니다.

요청 본문

이름	필수	형식	설명
recentPlayersByXuid	TRUE	ServerRecentPlayersByXuid[]	XUID와 해당 최근 플레이어를 나타내는 개체 배열입니다. 최소 1개, 최대 20개의 XUID 항목이 있어야 합니다.

응답

이름	형식	설명
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

EncounterType

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

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

ErrorResponse

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

Network

이름	형식	설명
XboxLive	string

ServerRecentPlayersByXuid

이름	형식	설명
recentPlayers	UnidirectionalRecentPlayer[]	이 사용자에 대한 최근 플레이어 배열입니다. 최소 1명, 최대 100명의 최근 플레이어가 있어야 합니다.
xuid	string	사용자의 XUID(10진수 정수)입니다.

ServerRecentPlayersRequest

이름	형식	설명
recentPlayersByXuid	ServerRecentPlayersByXuid[]	XUID와 해당 최근 플레이어를 나타내는 개체 배열입니다. 최소 1개, 최대 20개의 XUID 항목이 있어야 합니다.

ThrottledEntity

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

UnidirectionalRecentPlayer

이름	형식	설명
encounterType	EncounterType	최근 플레이어 만남의 유형입니다. 이 필드는 선택 사항이며 기본값은 Default입니다. Default에는 정해진 의미가 없으며, 이 값을 적절하게 해석하는 것은 호출자의 몫입니다.
id	string	다른 사용자의 ID(XUID 10진수 정수)입니다.
network	Network	다른 사용자를 만난 네트워크입니다.
timestamp	string

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

POST /titles/{titleId}/recentplayers/server

Post Server Recent Players

URI 매개 변수

요청 헤더

요청 본문

응답

정의

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer

​Post Server Recent Players

​URI 매개 변수

​요청 헤더

​요청 본문

​응답

​정의

​EncounterType

​ErrorResponse

​Network

​ServerRecentPlayersByXuid

​ServerRecentPlayersRequest

​ThrottledEntity

​UnidirectionalRecentPlayer

Post Server Recent Players

URI 매개 변수

요청 헤더

요청 본문

응답

정의

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer