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

# Limitación en PlayFab

> Cómo la limitación de PlayFab usa un límite de frecuencia de ventana fija con claves de todo el título, de todo el espacio de nombres y por entidad derivadas de los encabezados y cuerpos de las solicitudes.

La limitación se produce cuando un cliente intenta superar el límite de frecuencia de solicitudes de la API establecido para una API específica.
PlayFab aplica límites de limitación para garantizar un acceso equitativo a los recursos entre todos los títulos.

## Descripción de la limitación de PlayFab

PlayFab usa un algoritmo de limitación de frecuencia de ventana fija.

Cada solicitud de API realizada a PlayFab se traduce en una "clave". El valor de esta clave depende del contenido del encabezado y del cuerpo de la solicitud de API. Cada llamada API individual incrementa el recuento de su clave correspondiente.

Si una clave específica realiza más solicitudes de API de las permitidas dentro de un período de tiempo establecido (el límite de frecuencia), cualquier solicitud adicional que use esa clave se limita.

## Cómo determina PlayFab la clave para una solicitud de API específica

### Límites de frecuencia de API de todo el título

La **clave** es el identificador del título.

### Límites de frecuencia de API de todo el espacio de nombres

La **clave** es el identificador del espacio de nombres.

### Límites de frecuencia de API por entidad

* Para las API no autenticadas o anónimas (por ejemplo, las API `LoginWith[Platform]`), la **clave** es la dirección IP del cliente.
* Para las API autenticadas: la clave depende del encabezado y del cuerpo de la solicitud (que es lo que se usa para determinar la entidad que realiza la llamada y la entidad de destino de una API).
  * La entidad que realiza la llamada de una API es la entidad vinculada al token `X-Authorization`.
  * La entidad de destino de una API se define en el cuerpo de la solicitud y varía según la API. Para determinar a qué entidad se dirige, revise el cuerpo de la solicitud de esa API específica. Por ejemplo, la API GetUserData admite la especificación de una entidad diferente mediante PlayFabId en el cuerpo de su solicitud.
  * Si no se especifica ninguna entidad de destino en el cuerpo de la API, la **clave** es el identificador de la entidad que realiza la llamada.
  * Si se especifica una entidad de destino en el cuerpo de la API:
    * Si la entidad que realiza la llamada es de tipo MasterPlayerAccount, TitlePlayerAccount o Character (por ejemplo, la API se autenticó con un token `X-Authorization` asociado a uno de esos tipos de entidad), la **clave** es el identificador de la entidad que realiza la llamada.
    * Si la entidad que realiza la llamada NO es de uno de los tipos de entidad anteriores, la **clave** pasa a ser el identificador de la entidad de destino.

Estos son algunos ejemplos de la lógica de límites de frecuencia de API por entidad:

1. Un cliente con la dirección IP 23.192.228.80 llama a la API `Client/LoginWith[Platform]`. La clave de la solicitud de API es 23.192.228.80.
2. Un cliente llama a `Client/LinkCustomID` y proporciona un token `X-Authorization` que corresponde al identificador de cuenta de jugador maestra 408C36ADC841C0CD. No hay nada en el cuerpo de la solicitud de la API que mencione otro identificador de entidad. La clave de la solicitud de API es 408C36ADC841C0CD.
3. Un cliente llama a `Client/GetUserPublisherData` y proporciona un token `X-Authorization` que corresponde al identificador de cuenta de jugador maestra D5491A06D715E817. En el cuerpo de la solicitud, el cliente proporciona el valor de la cuenta de jugador maestra 25254A5AC4AEBA55 (por ejemplo, el cuerpo de la solicitud contiene PlayFabId:25254A5AC4AEBA55). La clave de la solicitud de API es D5491A06D715E817 porque la entidad que realiza la llamada aquí es una cuenta de jugador maestra.
4. Un cliente llama a `Client/GetUserPublisherData` y proporciona un token `X-Authorization` que corresponde al identificador de título 123. En el cuerpo de la solicitud, el cliente proporciona el valor de la cuenta de jugador maestra 25254A5AC4AEBA55 (por ejemplo, el cuerpo de la solicitud contiene PlayFabId:25254A5AC4AEBA55). La clave de la solicitud de API es 25254A5AC4AEBA55 porque la entidad que realiza la llamada aquí es un título.

### Ventajas de la limitación por entidad de destino

La limitación por entidad de destino es un mecanismo que aplica límites a determinadas operaciones en función del tipo de entidad a la que se dirigen. Estos límites ayudan a mantener la estabilidad del sistema y a evitar abusos, ofreciendo a los usuarios:

* Límites coherentes por jugador: escalar verticalmente el título no afecta a los límites de los jugadores individuales, lo que permite a los títulos ampliar su base de jugadores sin preocuparse por los límites de capacidad basados en el número de jugadores.
* Limitación uniforme de los jugadores: los jugadores experimentan los mismos límites de limitación independientemente de cuántos usuarios estén activos en un título, lo que permite a los desarrolladores detectar problemas de limitación de forma temprana, incluso con una base de usuarios pequeña.
* Estabilidad del servicio: la limitación evita que el tráfico de un solo jugador sature o afecte negativamente a los servicios de PlayFab o a una partición específica del plano de datos compartida entre varios títulos.

## Consulte también

* [Procedimientos recomendados y recomendaciones de limitación](/services/playfab/live-service-management/service-gateway/throttling/best-practices)
* [Límites de Economy v2](/services/playfab/economy-monetization/economy-v2/limits)


## Related topics

- [Procedimientos recomendados de limitación](/es/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [Autenticación de Microsoft Entra ID para las API de PlayFab](/es/services/playfab/identity/dev-identity/authentication/entra-id-api-authentication.md)
- [Documentación de administración de servicios en vivo de PlayFab](/es/services/playfab/live-service-management/index.md)
- [Información general del juego de demostración de PlayFab Winter Starfall](/es/services/playfab/demo-game/overview.md)
- [Contenido generado por el usuario de PlayFab](/es/services/playfab/economy-monetization/economy-v2/ugc/overview.md)
