> ## 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.

# POST /titles/{titleId}/invites

> Enviar invitación

# Enviar invitación

Envía una invitación a un usuario de XBOX Live.

Esta API permite que un cliente de juego envíe una invitación a un usuario de XBOX Live para un título específico. 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
```

## 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. |
| 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)
* [SendInviteRequest](#sendinviterequest)
* [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 | |

### SendInviteRequest

Si la plataforma no se establece en la solicitud, la invitación permitirá que el destinatario se una en cualquier plataforma en la que se pueda jugar al juego. De lo contrario, incluirá solo la plataforma indicada.

**Nota:** la excepción a esto es que, si Scarlett no está configurada como plataforma, las invitaciones que especifiquen XboxOne también se enviarán a los dispositivos Scarlett.

| 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) | |

### 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

- [API POST /titles/{titleId}/invites/server](https://docs.xbox.com/es/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-SendServerInvite.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](https://docs.xbox.com/es/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostUniRecentPlayers.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)