최근 플레이어 게시
사용자의 최근 플레이어 목록을 추가하거나 업데이트합니다(단방향).
이 API를 사용하면 게임 클라이언트가 사용자의 최근 플레이어 목록에 추가하고 기존의 최근 플레이어 항목을 업데이트할 수 있습니다. 이 호출은 호출자의 최근 플레이어 목록(단방향)에만 영향을 줍니다.
POST /titles/{titleId}/recentplayers
URI 매개 변수
| 매개 변수 |
그런 다음 |
필수 |
유형 |
설명 |
| titleId |
path |
TRUE |
정수 |
요청이 전송되는 게임의 titleId입니다. |
| 이름 |
필수 |
유형 |
설명 |
| Authorization |
TRUE |
정수 |
호출자는 XBL 3.0 인증 형식으로 XToken을 제공해야 합니다. 예를 들어 권한 부여: XBL3.0 x=2553948354698;>암호화된 토큰<) |
| 콘텐츠 종류 |
TRUE |
문자열 |
ContentType을 application/json으로 설정해야 합니다. |
요청 본문
| 이름 |
필수 |
유형 |
설명 |
| recentPlayers |
TRUE |
|
이 사용자의 최근 플레이어 배열입니다. 최근 플레이어는 최소 1명, 최근 플레이어는 최대 100명이어야 합니다. |
응답
| 이름 |
유형 |
설명 |
| 204 콘텐츠 없음 |
|
최근 플레이어 요청이 성공적으로 전송되었습니다. |
| 400 잘못된 요청 |
ErrorResponse |
요청을 처리하는 동안 오류가 발생했습니다. 가능한 오류 코드: "RequestValidationError: 요청 유효성 검사가 실패했습니다.", " AuthorizationError: 호출자는 리소스에 액세스할 수 없습니다." |
| 기타 상태 코드 |
ThrottledEntity |
요청이 너무 많습니다. 헤더 Retry-After: 정수 |
용어 정의
ClientRecentPlayersRequest
| 이름 |
유형 |
설명 |
| recentPlayers |
|
이 사용자의 최근 플레이어 배열입니다. 최근 플레이어는 최소 1명, 최근 플레이어는 최대 100명이어야 합니다. |
EncounterType
최근 플레이어가 만나는 유형입니다. 이 필드는 선택 사항이며 기본값은 기본값입니다. 기본값에는 규정된 의미가 없습니다. 이 값을 적절하게 해석하는 것은 호출자에게 달려 있습니다.
| 이름 |
유형 |
설명 |
| 기본 |
문자열 |
|
| 상대 |
문자열 |
|
| 팀원 |
문자열 |
|
ErrorResponse
| 이름 |
유형 |
설명 |
| 디버그 메시지 |
문자열 |
디버깅에 사용할 수 있는 오류 메시지의 사람이 읽을 수 있는 버전입니다. |
| errorCode |
문자열 |
오류 코드 열거형. |
네트워크
ThrottledEntity
| 이름 |
유형 |
설명 |
| currentRequests |
문자열 |
현재 요청 수 - 동시성 또는 속도입니다. |
| 디버그 메시지 |
문자열 |
디버깅에 사용할 수 있는 스로틀 메시지의 사람이 읽을 수 있는 버전입니다. |
| 제한 유형 |
문자열 |
제한 유형, 즉 동시성 또는 비율입니다. |
| maxRequests |
문자열 |
허용되는 최대 요청 수 - 동시성 또는 속도. |
| periodInSeconds |
문자열 |
속도 또는 동시성 제한이 초과될 때 적용되는 기간(초)입니다. |
| version |
문자열 |
현재 스로틀 계약 버전입니다. |