Skip to content

HubsGGx/Info-Player-FreeFire

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 

Repository files navigation

Frifas Info API - Documentação Completa

Sistema de consulta de informações de jogadores do Free Fire, incluindo dados detalhados da conta e geração de imagem do personagem com roupa equipada.

A Frifas Info API oferece endpoints para desenvolvedores que desejam obter informações públicas de jogadores do Free Fire, como nível, rank, clã, itens equipados e uma imagem personalizada do personagem. Esta documentação descreve detalhadamente os endpoints, payloads de resposta e tratamentos de erro.


Informações Gerais

  • Base URL: https://fluxdevservice.com/api/frifas
  • Formato de Dados: JSON
  • Autenticação: Chave de API via parâmetro key
  • Timeout Padrão: 30 segundos

1. Info Player

Obtém informações detalhadas de uma conta do Free Fire, incluindo dados de ranking, pet, perfil, clã e informações sociais.

Endpoint: GET /info-player?key={KEY}&id={UID}

Parâmetros

Parâmetro Tipo Obrigatório Descrição
key string Sim Chave de API válida
id string Sim UID do jogador (ex: 123456789)

Resposta de Sucesso (200 OK)

{
  "success": true,
  "status": "SUCESSO_PLAYER",
  "message": "informações do jogador obtidas com sucesso!",
  "statuscode": 200,
  "data": [
    {
      "conta": {
        "nome_conta": "Nergal(666)",
        "id_conta": "2040547648",
        "experiencia": 27981,
        "level": 23,
        "likes": 506,
        "region": "BR",
        "prime_level": 0,
        "release_version": "OB53",
        "credibilidade": 98,
        "criado_em": "29/10/2020 - 15:33:11",
        "ultimo_login": "02/06/2026 - 14:23:40",
        "idade_conta": {
          "anos": 5,
          "meses": 7,
          "dias": 3,
          "horas": 23,
          "minutos": 11
        },
        "rank_br": {
          "rank": 315,
          "pontos": 2635,
          "max_rank": 315
        },
        "rank_cs": {
          "rank": 301,
          "pontos": 1,
          "max_rank": 301
        },
        "titulo": 904090004,
        "badge": {
          "id": 1001000097,
          "quantidade": 1
        },
        "pet": {
          "id": 1300000091,
          "experiencia": 509,
          "selecionado": true,
          "level": 4,
          "habilidade_id": 1315000008,
          "skin_id": 1310000092
        },
        "perfil": {
          "avatar_id": 102000005,
          "cor_pele": 50,
          "roupas": [205000048, 214000000, 211000000, 204000527, 211052047, 203000937],
          "habilidades_equipadas": [16, 4706, 8, 1, 16, 6501, 8, 2, 16, 4806, 8, 3, 16, 5206]
        },
        "cla": {
          "id": "2064493049",
          "nome": "OS_ALFAS+",
          "level": 3,
          "capacidade": 35,
          "membros": 31,
          "capitao_id": "13830004423",
          "capitao_nome": "PARZIVAL-JC"
        },
        "informacoes_sociais": {
          "idioma": "Language_PORTUGUESE",
          "assinatura": "Só quem se arrisca merece viver o extraordinário!!"
        }
      }
    }
  ]
}

Tabela de Erros

HTTP Código Descrição
400 ID_REQUIRED O parâmetro id não foi informado
401 INVALID_KEY Chave de API não fornecida ou inválida
500 ERRO_INTERNO Erro interno ao processar a requisição

2. Get Skin

Retorna informações básicas da conta e gera uma imagem do personagem com a roupa, pet e itens atualmente equipados.

Endpoint: GET /get-skin?key={KEY}&id={UID}

Parâmetros

Parâmetro Tipo Obrigatório Descrição
key string Sim Chave de API válida
id string Sim UID do jogador (ex: 123456789)

Resposta de Sucesso (200 OK)

{
  "success": true,
  "status": "SUCESSO_PLAYER",
  "message": "informações do jogador obtidas com sucesso!",
  "statuscode": 200,
  "data": [
    {
      "conta": {
        "nome_conta": "PlayerName",
        "id_conta": "123456789",
        "criado_em": "15/03/2020 - 14:30:22",
        "ultimo_login": "20/01/2025 - 09:45:10",
        "images": {
          "download_id": "abc123def456",
          "download_get": "https://d3.hubsdev.com/download/abc123def456"
        }
      }
    }
  ]
}

Tabela de Erros

HTTP Código Descrição
400 ERRO_ID_AUSENTE O parâmetro id não foi informado
401 INVALID_KEY Chave de API não fornecida ou inválida
404 ERRO_JOGADOR_NAO_ENCONTRADO Jogador não encontrado ou UID inexistente
404 ERRO_SEM_IDS Nenhum item equipado encontrado para gerar imagem
502 ERRO_SERVICO_INDISPONIVEL Serviço externo temporariamente indisponível
502 ERRO_CONEXAO Falha na comunicação com o serviço de geração
504 ERRO_TIMEOUT Tempo limite de 30 segundos excedido

Regras de Negócio

  • Contabilização de Uso: Cada requisição válida (200 OK) consome 1 crédito da chave de API.
  • Região Padrão: As consultas utilizam a região br (Brasil).
  • Timeout: Operações com tempo limite de 30 segundos – em caso de estouro, retorna erro 504.
  • Imagens: A imagem gerada pelo endpoint /get-skin é hospedada em https://d3.hubsdev.com e o link tem validade limitada (recomenda-se download/localização própria para armazenamento).
  • Resposta de info player: Em beta, pode haver mudanças em breve, mas iremos notificar neste repositório.

Frifas API Service - Documentação Oficial

About

API de consulta de jogadores do Free Fire. Obtenha informações da conta e uma imagem do personagem com a roupa atualmente equipada.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors