Post Server 최근 플레이어 그룹

그룹 내 모든 사용자의 최근 플레이어를 추가하거나 업데이트합니다(양방향).

이 API를 사용하면 게임 서버가 사용자의 최근 플레이어 목록에 추가하고 기존의 최근 플레이어 항목을 업데이트할 수 있습니다. 그룹 내의 모든 사용자가 서로의 최근 플레이어 목록(양방향)에 추가됩니다.

최근 플레이어 그룹의 예: [ [A,B,C], [A,D], [E,F] ].

A는 B, C, D를 만났습니다. B는 A와 C를 만났습니다. D는 A만 만났습니다.

POST /titles/{titleId}/recentplayergroups/server

URI 매개 변수

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

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

이름	필수	유형	설명
recentPlayerGroups	TRUE	RecentPlayerGroup[]	양방향 최근 플레이어 그룹의 배열입니다. 그룹이 최소 1개, 최대 20개 있어야 합니다. 각 그룹 내에는 2명 이상의 플레이어와 최대 100명의 플레이어가 있어야 합니다.

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

이름	유형	설명
id	문자열	다른 사용자의 ID(XUID 기본 10 정수)입니다.
network	네트워크	다른 사용자가 발견된 네트워크입니다.

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

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

이름	유형	설명
XboxLive	문자열

그룹 내의 모든 사용자가 지정된 시간에 서로 만났습니다. 각 그룹에는 최소 2명 최대 100명의 사용자가 포함되어야 합니다.

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

그룹 내의 모든 사용자가 지정된 시간에 서로 만났습니다. 각 그룹에는 최소 2명 최대 100명의 사용자가 포함되어야 합니다.

이름	유형	설명
recentPlayerGroups	RecentPlayerGroup	양방향 최근 플레이어 그룹의 배열입니다. 그룹이 최소 1개, 최대 20개 있어야 합니다. 각 그룹 내에는 2명 이상의 플레이어와 최대 100명의 플레이어가 있어야 합니다.

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