API de Free Fire para consultar perfiles y estadísticas
Consulta datos de jugadores de Free Fire con su UID
¿Quieres mostrar información de una cuenta de Free Fire en tu web o aplicación? Esta API reúne consultas para obtener el perfil de un jugador, revisar sus estadísticas y solicitar imágenes de su banner y outfit.
En este artículo te explicamos qué puedes consultar y cómo funciona cada recurso. La API es un servicio independiente y no oficial de Garena. La información disponible depende de los datos que proporcione el servicio de origen.
Qué puedes consultar con la API
La API organiza cada tipo de información en una consulta distinta:
- Perfil del jugador, con datos públicos disponibles de la cuenta, como el apodo.
- Banner del perfil, mediante un enlace temporal a la imagen.
- Estadísticas, para Battle Royale y Duelo de Escuadras, tanto de carrera como de clasificatoria.
- Outfit, con un enlace temporal a la imagen del personaje y su equipamiento.
- Información general proporcionada por el servicio de origen.
Esta separación permite solicitar cada recurso cuando se necesita. Por ejemplo, una aplicación puede cargar primero los datos del perfil y pedir la imagen del banner cuando vaya a mostrarla.
El UID y la región identifican al jugador
Para consultar una cuenta necesitas su UID, el identificador numérico del jugador. El apodo no lo sustituye, ya que puede cambiar.
También debes indicar la región correcta de la cuenta. Si seleccionas una región que no corresponde al jugador, la consulta podría no encontrar sus datos. La región predeterminada es SAC; en la documentación puedes revisar las demás regiones disponibles.
Consultar el perfil de Free Fire
La consulta de perfil obtiene la información pública disponible para el UID y la región indicados. La respuesta llega en formato JSON, un formato que las páginas web y aplicaciones pueden procesar para mostrar los datos con su propio diseño.
Con esta información puedes crear una ficha de jugador, mostrar su apodo y presentar los datos de perfil que devuelve el servicio. La consulta del perfil va por separado de las imágenes, así que puedes decidir cuándo cargar el banner o el outfit.
Ver o descargar el banner de una cuenta
El banner se obtiene mediante una consulta propia. La respuesta incluye un enlace temporal a la imagen, que puedes usar para mostrarla en tu página o abrirla para guardarla.
El enlace tiene una vigencia de cinco minutos. Cuando expire, solicita el banner nuevamente para obtener otra dirección. Por eso, la URL recibida no debe tratarse como un enlace permanente.
Consultar estadísticas de Battle Royale y Duelo de Escuadras
Puedes solicitar estadísticas de Battle Royale o de Duelo de Escuadras, y elegir entre datos de carrera y de clasificatoria. Esto permite consultar cada modo por separado y presentar la información de forma más clara.
La respuesta contiene los datos disponibles para la cuenta, el modo y el tipo de partida seleccionados. La documentación interactiva muestra los campos exactos que devuelve cada consulta y permite probar diferentes opciones.
Mostrar la imagen del outfit
La consulta de outfit genera un enlace temporal a una imagen del personaje y su equipamiento. Puedes utilizarlo para enseñar visualmente el aspecto de una cuenta junto a la información del jugador.
Al igual que el banner, la imagen del outfit se entrega mediante una URL que vence después de cinco minutos. Si el enlace ya expiró, vuelve a solicitar la imagen.
Consultar información general
La API también cuenta con una consulta de información general del servicio de origen. Para ver qué datos incluye exactamente, puedes probar este endpoint desde la documentación interactiva y revisar el formato de la respuesta.
Cómo funciona el acceso con token
Si consultas la API desde otro dominio o desde un servidor externo, necesitas un token vigente. Se envía en el encabezado de autorización con el formato Bearer. No lo agregues a la URL de la consulta.
Los tokens son temporales. La duración predeterminada es de 24 horas y el administrador puede configurarla. Si el token vence o se revoca, tendrás que generar otro. Guarda su valor cuando lo crees, porque el panel solo lo muestra completo en ese momento.
Qué hacer si una consulta no funciona
Primero verifica que el UID y la región correspondan a la cuenta que quieres consultar. Para las estadísticas, confirma también que seleccionaste el modo y el tipo de partida correctos.
Si haces la solicitud desde otro dominio, revisa que el token siga vigente y que esté enviado como Bearer en el encabezado. Si estás cargando un banner o un outfit, comprueba que el enlace temporal no haya vencido.
Prueba la API desde la documentación
La documentación interactiva reúne las consultas disponibles, las regiones admitidas, los campos que puedes enviar y la estructura de las respuestas. También permite probar los endpoints y ver qué información devuelve cada uno.
Genera tu token de acceso
Solicita un token temporal para conectar una web o aplicación con la API.
Si quieres conocer otros artículos parecidos a API de Free Fire para consultar perfiles y estadísticas puedes visitar la categoría Free Fire.
Deja una respuesta