Códigos de error globales de los métodos de API

• Code: el código de error HTTP devuelto por el servidor
• ErrorCode: un código de error numérico específico de PlayFab.
• Error: un código legible por humanos específico de PlayFab.
• ErrorMessage: una descripción del error que proporciona contexto adicional útil para la depuración.
• ErrorDetails: no siempre está presente. Proporciona contexto adicional para determinados tipos de errores.

​

Códigos con reintento seguro

• APIClientRequestRateLimitExceeded (1199): indica demasiadas llamadas en una ráfaga corta.
• APIConcurrentRequestLimitExceeded (1342): indica demasiadas llamadas simultáneas.
• ConcurrentEditError (1133): indica demasiadas llamadas simultáneas o llamadas secuenciales muy rápidas.
• DataUpdateRateExceeded (1287): indica demasiadas llamadas simultáneas o llamadas secuenciales muy rápidas.
• DownstreamServiceUnavailable (1127): indica que PlayFab o un servicio de terceros podría estar teniendo un problema temporal.
• ServiceUnavailable (1123): indica que PlayFab puede estar teniendo un problema temporal o que el cliente está haciendo demasiadas llamadas de API demasiado rápido. Si reintenta esta solicitud, es importante usar correctamente una estrategia de retroceso exponencial.

​

Códigos que nunca deben reintentarse

• AccountBanned (1002):
  La cuenta del jugador ha sido bloqueada; todos los métodos de API fallarán con este error.
• AccountDeleted (1322): la cuenta del jugador se ha eliminado; todos los métodos de API fallarán con este error.
• AccountNotFound (1001): la cuenta del jugador no existe, probablemente porque no está copiando correctamente un PlayFabId/TitlePlayerId. Este error siempre se producirá si el identificador no es correcto.
• APIRequestsDisabledForTitle (1295): todas las solicitudes de API se han deshabilitado para este título y ya no se puede usar.
• InvalidContentType (1144): debería ser imposible recibir este error si usa uno de nuestros SDK. Si está haciendo sus propias llamadas HTTPS sin procesar a los métodos de API de PlayFab, el encabezado Content-Type debe ser application/json. No se aceptan otros formatos.
• InvalidEntityType (1373): el tipo de entidad del token utilizado para la autenticación no es compatible con esta API.
• InvalidParams (1000): el objeto de solicitud de API enviado a PlayFab tiene parámetros no válidos y no se puede ejecutar.
• InvalidRequest (1071): el objeto de solicitud de API enviado a PlayFab no es válido y no se puede ejecutar.
• InvalidTitleId (1004): la solicitud proporcionó un TitleId que no coincide con el título proporcionado en la URL del método. En la mayoría de los SDK, no debería especificar un TitleId para las solicitudes de inicio de sesión, ya que se hace por usted. En la API de administración, los TitleId explícitos son una característica de seguridad de Dev->Test->Live.
• NotAuthenticated (1074): el cliente ha intentado llamar a una API que requiere autenticación con SessionTicket, sin iniciar sesión primero.
• NotAuthorized (1089): credenciales incorrectas u otras entradas erróneas relacionadas con el inicio de sesión.
• NotAuthorizedByTitle (1191): este método se ha deshabilitado mediante la directiva de API y no se puede llamar.
• ProfileDoesNotExist (1298): se intentó acceder a una entidad (jugador, personaje, título, etc.) que no existe. Probablemente sea un error tipográfico o tenga una entrada incorrecta en alguna parte.
• TitleDeleted (1347): este título se ha eliminado de PlayFab y ya no se puede usar.
• UnknownError (1039): esto suele producirse si se envía información incorrecta a un complemento de terceros y nuestro servidor experimentó un resultado o error desconocido al interactuar con sistemas externos. Para resolverlo, experimente con sus entradas e intente determinar si son inválidas de alguna manera. De lo contrario, informe del error en los foros, con su titleId, el JSON completo de la solicitud (si es posible) y la salida del error. Postman es una herramienta útil para depurar esta situación.
• InvalidAPIEndpoint (1131): indica que la URL de esta solicitud no es válida para este título.
• OverLimit (1214): indica que un intento de realizar una operación hará que el uso del servicio supere el límite mostrado en las páginas de límites de Game Manager. Evalúe los detalles de error devueltos para determinar qué límite se superaría.

​

Otros códigos de error destacables

• APIConcurrentRequestLimitExceeded (1342): su título está usando CloudScript de manera demasiado intensiva, o está intentando forzar la evaluación de segmentos con demasiada frecuencia (o ambas cosas). En el primer caso, las dos cosas que hay que examinar son:
  1. Con qué frecuencia las llamadas de sus scripts utilizan un tiempo cercano al máximo por llamada (o peor, agotan el tiempo de espera).
  2. Con qué frecuencia llama a CloudScript por jugador. Las llamadas para obtener la lista de jugadores de un segmento serían lo principal que examinar (una tarea dirigida a un segmento también provoca una reevaluación, pero eso debería ser poco frecuente).
• ConnectionTimeout (2): dependiendo de los detalles del SDK que use y de la pila de red subyacente, es posible ver errores como ConnectionError, ConnectionTimeout u otros errores relacionados con dificultades para contactar con los servidores de PlayFab. Todos ellos son indicativos de problemas de red. La fuente más común es una desconexión en el lado del cliente. También es posible recibirlos cuando el enrutamiento de Internet entre el cliente y los servidores de PlayFab se interrumpe por alguna razón. Un juego puede hacer muy poco para gestionar estos errores. La mejor respuesta es informar a los llamadores ascendentes o al jugador de que no se puede establecer una conexión. Después podrían iniciar la operación de nuevo más tarde.