> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /titles/{titleId}/recentplayergroups/server

> Post Server Recent Player Group

# Post Server Recent Player Group

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

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

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

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

```http theme={null}
POST /titles/{titleId}/recentplayergroups/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으로 설정해야 합니다. |

## 요청 본문

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

## 응답

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

## 정의

* [BidirectionalRecentPlayer](#bidirectionalrecentplayer)
* [EncounterType](#encountertype)
* [ErrorResponse](#errorresponse)
* [Network](#network)
* [RecentPlayerGroup](#recentplayergroup)
* [ServerRecentPlayerGroupsRequest](#serverrecentplayergroupsrequest)
* [ThrottledEntity](#throttledentity)

### BidirectionalRecentPlayer

| 이름 | 형식 | 설명 |
| - | - | - |
| id | string | 다른 사용자의 ID(XUID 10진수 정수)입니다. |
| network | [Network](#network) | 다른 사용자를 만난 네트워크입니다. |

### EncounterType

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

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

### ErrorResponse

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

### Network

| 이름 | 형식 | 설명 |
| - | - | - |
| XboxLive | string | |

### RecentPlayerGroup

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

| 이름 | 형식 | 설명 |
| - | - | - |
| encounterType | [EncounterType](#encountertype) | 최근 플레이어 만남의 유형입니다. 이 필드는 선택 사항이며 기본값은 Default입니다. Default에는 정해진 의미가 없으며, 이 값을 적절하게 해석하는 것은 호출자의 몫입니다. |
| recentPlayers | [BidirectionalRecentPlayer](#bidirectionalrecentplayer)\[] | |
| timestamp | string | |

### ServerRecentPlayerGroupsRequest

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

| 이름 | 형식 | 설명 |
| - | - | - |
| recentPlayerGroups | [RecentPlayerGroup](#recentplayergroup) | 양방향 최근 플레이어 그룹 배열입니다. 최소 1개, 최대 20개의 그룹이 있어야 합니다. 각 그룹 내에는 최소 2명, 최대 100명의 플레이어가 있어야 합니다. |

### ThrottledEntity

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


## Related topics

- [TitleId Element (MicrosoftGame.config)](https://devdocs.xbox.com/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [TitleId 요소(MicrosoftGame.config)](https://devdocs.xbox.com/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [TitleId 元素 (MicrosoftGame.config)](https://devdocs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [Élément MicrosoftGame.config - TitleId](https://devdocs.xbox.com/fr/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [TitleId 要素 (MicrosoftGame.config)](https://devdocs.xbox.com/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)