Post Server 최근 플레이어

사용자의 최근 플레이어 목록 세트를 추가하거나 업데이트합니다(단방향). 기본적으로 서버용 클라이언트 API의 배치 API입니다.

이 API를 사용하면 게임 서버가 사용자의 최근 플레이어 목록에 추가하고 기존의 최근 플레이어 항목을 업데이트할 수 있습니다. 각 사용자의 최근 플레이어 목록은 단방향입니다.

POST /titles/{titleId}/recentplayers/server

URI 매개 변수

매개 변수	그런 다음	필수	유형	설명
titleId	path	TRUE	정수	요청이 전송되는 게임의 titleId입니다.

이름	필수	유형	설명
Authorization	TRUE	정수	호출자는 XBL 3.0 인증 형식으로 XToken을 제공해야 합니다. 예를 들어 권한 부여: XBL3.0 x=2553948354698;>암호화된 토큰<)
콘텐츠 종류	TRUE	문자열	ContentType을 application/json으로 설정해야 합니다.

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

이름	유형	설명
204 콘텐츠 없음		최근 플레이어 요청이 성공적으로 전송되었습니다.
400 잘못된 요청	ErrorResponse	요청을 처리하는 동안 오류가 발생했습니다. 가능한 오류 코드: "RequestValidationError: 요청 유효성 검사가 실패했습니다.", " AuthorizationError: 호출자는 리소스에 액세스할 수 없습니다."
기타 상태 코드	ThrottledEntity	요청이 너무 많습니다. 헤더 Retry-After: 정수

최근 플레이어가 만나는 유형입니다. 이 필드는 선택 사항이며 기본값은 기본값입니다. 기본값에는 규정된 의미가 없습니다. 이 값을 적절하게 해석하는 것은 호출자에게 달려 있습니다.

이름	유형	설명
디버그 메시지	문자열	디버깅에 사용할 수 있는 오류 메시지의 사람이 읽을 수 있는 버전입니다.
errorCode	문자열	오류 코드 열거형.

이름	유형	설명
XboxLive	문자열

이름	유형	설명
recentPlayers	UnidirectionalRecentPlayer[]	이 사용자의 최근 플레이어 배열입니다. 최근 플레이어는 최소 1명, 최근 플레이어는 최대 100명이어야 합니다.
xuid	문자열	사용자의 XUID(기본 10 정수)입니다.

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

이름	유형	설명
currentRequests	문자열	현재 요청 수 - 동시성 또는 속도입니다.
디버그 메시지	문자열	디버깅에 사용할 수 있는 스로틀 메시지의 사람이 읽을 수 있는 버전입니다.
제한 유형	문자열	제한 유형, 즉 동시성 또는 비율입니다.
maxRequests	문자열	허용되는 최대 요청 수 - 동시성 또는 속도.
periodInSeconds	문자열	속도 또는 동시성 제한이 초과될 때 적용되는 기간(초)입니다.
version	문자열	현재 스로틀 계약 버전입니다.

이름	유형	설명
encounterType	EncounterType	최근 플레이어가 만나는 유형입니다. 이 필드는 선택 사항이며 기본값은 기본값입니다. 기본값에는 규정된 의미가 없습니다. 이 값을 적절하게 해석하는 것은 호출자에게 달려 있습니다.
id	문자열	다른 사용자의 ID(XUID 기본 10 정수)입니다.
network	네트워크	다른 사용자가 발견된 네트워크입니다.
timestamp	문자열