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

# API POST /titles/{titleId}/invites/server

> Enviar invitación de servidor

# Enviar invitación de servidor

Envía una invitación a un usuario de XBOX con la cadena de conexión especificada.

Esta API permite que un servidor de juego envíe una invitación a un usuario de XBOX Live. El cuerpo de la solicitud contiene una cadena de conexión que el invitado usa para unirse al servidor. La cadena de conexión puede contener la IP del servidor de juego o un puntero a una sesión en la que se encuentra el usuario. La invitación se envía a todos los puntos de conexión registrados, independientemente de la plataforma.

```http theme={null}
POST /titles/{titleId}/invites/server
```

## Parámetros de URI

| Parámetro | En | Obligatorio | Tipo | Descripción |
| - | - | - | - | - |
| titleId | path | TRUE | integer | El titleId del juego para el que se envía la solicitud. |

## Encabezado de la solicitud

| Nombre | Obligatorio | Tipo | Descripción |
| - | - | - | - |
| Authorization | TRUE | integer | El autor de la llamada debe proporcionar un XToken en el formato de autorización XBL 3.0. Por ejemplo, Authorization: XBL3.0 x=2553948354698;>encrypted token\<) |
| Content-Type | TRUE | string | ContentType debe establecerse en application/json |

## Cuerpo de la solicitud

| Nombre | Obligatorio | Tipo | Descripción |
| - | - | - | - |
| invitedUsers | TRUE | string\[] | El XUID de los usuarios a los que se envía la invitación. El XUID se representa como un entero en base 10. El máximo es de 16 XUID. |
| sender | TRUE | string | El identificador del usuario en cuyo nombre se envía la invitación. |
| connectionString | | string | La cadena de conexión es lo que se pasa al juego cuando la invitación llega al usuario. La cadena de conexión suele contener información como la IP del servidor para permitir que el usuario invitado pueda unirse. Si el campo de la cadena de conexión se deja vacío, el título se invoca con una cadena de conexión vacía. La longitud de la cadena de conexión está limitada a 512 caracteres. |
| platform | | [Platform](#platform) | |

## Respuestas

| Nombre | Tipo | Descripción |
| - | - | - |
| 204 No Content | | |
| La invitación se envió correctamente. | | |
| 400 Bad Request | [ErrorResponse](#errorresponse) | Se produjo un error al procesar la solicitud. Códigos de error posibles: "RequestValidationError: The request validation has failed.", " AuthorizationError: The caller is not allowed to access the resource. Too many requests." |
| Otros códigos de estado | [ThrottledEntity](#throttledentity) | Demasiadas solicitudes. Encabezados Retry-After: integer |

## Definiciones

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

### ErrorResponse

| Nombre | Tipo | Descripción |
| - | - | - |
| debugMessage | string | Versión legible del mensaje de error que se puede usar para depurar. |
| errorCode | string | Enumeración de códigos de error. |

### Platform

| Nombre | Tipo | Descripción |
| - | - | - |
| Android | string | |
| IOS | string | |
| Nintendo | string | |
| PlayStation | string | |
| Scarlett | string | |
| Win32 | string | |
| WindowsOneCore | string | |
| XboxOne | string | |

### SendServerInviteRequest

| Nombre | Tipo | Descripción |
| - | - | - |
| connectionString | string | La cadena de conexión es lo que se pasa al juego cuando la invitación llega al usuario. La cadena de conexión suele contener información como la IP del servidor para permitir que el usuario invitado pueda unirse. Si el campo de la cadena de conexión se deja vacío, el título se invoca con una cadena de conexión vacía. La longitud de la cadena de conexión está limitada a 512 caracteres. |
| invitedUsers | string\[] | El XUID de los usuarios a los que se envía la invitación. El XUID se representa como un entero en base 10. El máximo es de 16 XUID. |
| platform | [Platform](#platform) | |
| sender | string | El identificador del usuario en cuyo nombre se envía la invitación. |

### ThrottledEntity

| Nombre | Tipo | Descripción |
| - | - | - |
| currentRequests | string | Número actual de solicitudes: simultaneidad o frecuencia. |
| debugMessage | string | Versión legible del mensaje de limitación que se puede usar para depurar. |
| limitType | string | El tipo de límite, es decir, simultaneidad o frecuencia. |
| maxRequests | string | Número máximo de solicitudes permitidas: simultaneidad o frecuencia. |
| periodInSeconds | string | El período en segundos que se aplica cuando se superan los límites de frecuencia o simultaneidad. |
| version | string | Versión actual del contrato de limitación. |


## Related topics

- [POST /titles/{titleId}/invites](https://docs.xbox.com/es/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-SendInvite.md)
- [POST /titles/{titleId}/activities/query](https://docs.xbox.com/es/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-ExternalGetActivityBatch.md)
- [POST /titles/{titleId}/recentplayers/server](https://docs.xbox.com/es/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostServerUniRecentPlayers.md)
- [POST /titles/{titleId}/recentplayergroups/server](https://docs.xbox.com/es/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostServerRecentPlayerGroup.md)
- [POST /titles/{titleId}/recentplayers](https://docs.xbox.com/es/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostUniRecentPlayers.md)