> ## 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}/invites/server API

> Send Server Invite

# Send Server Invite

지정된 연결 문자열로 XBOX 사용자에게 초대를 보냅니다.

이 API를 통해 게임 서버는 XBOX Live 사용자에게 초대를 보낼 수 있습니다. 요청 본문에는 초대받은 사람이 서버에 참여하기 위해 사용하는 연결 문자열이 포함됩니다. 연결 문자열에는 게임 서버 IP 또는 사용자가 있는 세션에 대한 포인터가 포함될 수 있습니다. 초대는 플랫폼에 관계없이 등록된 모든 엔드포인트로 전송됩니다.

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

## 요청 본문

| 이름 | 필수 | 형식 | 설명 |
| - | - | - | - |
| invitedUsers | TRUE | string\[] | 초대가 전송되는 사용자의 XUID입니다. XUID는 10진수 정수로 표현됩니다. 최대 16개의 XUID입니다. |
| sender | TRUE | string | 대신하여 초대가 전송되는 사용자의 ID입니다. |
| connectionString | | string | 연결 문자열은 초대가 사용자에게 도달하면 게임에 전달되는 값입니다. 연결 문자열에는 일반적으로 초대된 사용자가 참여할 수 있도록 서버 IP와 같은 정보가 포함됩니다. 연결 문자열 필드가 비어 있으면 타이틀은 빈 연결 문자열로 호출됩니다. 연결 문자열의 길이는 512자로 제한됩니다. |
| platform | | [Platform](#platform) | |

## 응답

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

## 정의

* [ErrorResponse](#errorresponse)
* [Platform](#platform)
* [SendServerInviteRequest](#sendserverinviterequest)
* [ThrottledEntity](#throttledentity)

### ErrorResponse

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

### Platform

| 이름 | 형식 | 설명 |
| - | - | - |
| Android | string | |
| IOS | string | |
| Nintendo | string | |
| PlayStation | string | |
| Scarlett | string | |
| Win32 | string | |
| WindowsOneCore | string | |
| XboxOne | string | |

### SendServerInviteRequest

| 이름 | 형식 | 설명 |
| - | - | - |
| connectionString | string | 연결 문자열은 초대가 사용자에게 도달하면 게임에 전달되는 값입니다. 연결 문자열에는 일반적으로 초대된 사용자가 참여할 수 있도록 서버 IP와 같은 정보가 포함됩니다. 연결 문자열 필드가 비어 있으면 타이틀은 빈 연결 문자열로 호출됩니다. 연결 문자열의 길이는 512자로 제한됩니다. |
| invitedUsers | string\[] | 초대가 전송되는 사용자의 XUID입니다. XUID는 10진수 정수로 표현됩니다. 최대 16개의 XUID입니다. |
| platform | [Platform](#platform) | |
| sender | string | 대신하여 초대가 전송되는 사용자의 ID입니다. |

### ThrottledEntity

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


## Related topics

- [Invites](https://devdocs.xbox.com/services/xbox-services/multiplayer/mpa/concepts/live-mpa-invites.md)
- [Quickstart PlayFab REST API collection for Postman](https://devdocs.xbox.com/services/playfab/sdks/postman/postman-quickstart.md)
- [Exemple Windows Runner](https://devdocs.xbox.com/fr/services/playfab/multiplayer/servers/windows-runner-sample.md)
- [Início rápido da coleção da API REST do PlayFab para Postman](https://devdocs.xbox.com/pt-BR/services/playfab/sdks/postman/postman-quickstart.md)
- [适用于 Postman 的 PlayFab REST API 集合快速入门](https://devdocs.xbox.com/zh-CN/services/playfab/sdks/postman/postman-quickstart.md)