TROPA DEVELOPERS / DOCUMENTAÇÃO

Seu código.
Todos os esportes.

Do primeiro acesso à integração. Consulte a API Sport, o receptor APICRON e a IMG API de jogadores e imagens.

FUTEBOLNBAUFC / MMAIMG APIJSON
01 / COMECE AQUI

Uma conexão.
Diferentes modalidades.

A API fornece informações esportivas para seu site, aplicativo ou sistema: jogos e eventos, horários, placares e canais, conforme a modalidade e os dados disponíveis.

01 / FUTEBOLDentro de campo.

Feeds separados para os jogos de hoje e de amanhã.

02 / NBADentro da quadra.

Feed de basquete liberado conforme o plano contratado.

03 / UFCNo octógono.

Feed de eventos e lutas do UFC.

Dois caminhos para integrar

Leia o JSON autenticado pela URL do painel ou use o receptor apicron.php na sua hospedagem para receber e servir os dados localmente.

02 / SEU PRIMEIRO ACESSO

Configure a conexão.

  1. Crie sua conta e ative um plano.O acesso depende de assinatura aprovada, vigente e com a modalidade liberada.
  2. Abra a área do cliente.Na modalidade desejada, use “Copiar JSON” para obter a URL completa.
  3. Consuma a URL no seu servidor.O token identifica seu acesso. Mantenha-o no backend, fora de repositórios e código público.
GET

Endpoint do JSON utilizado pelo painel

Use a URL pronta da sua área do cliente e selecione a modalidade contratada.

URL BASE
https://apisport.tropatech.com.br/user/ver_json.php
ParâmetroObrigatórioUso
tokenSimToken ativo disponível na sua área do cliente.
modalidadeSimUm dos identificadores listados nesta documentação.
URL pronta no painel

Prefira copiar o link gerado na sua conta. Não é necessário enviar senha, e-mail ou Telegram ID para este endpoint.

03 / ESCOLHA A MODALIDADE

Cada esporte, seu feed.

Todas as chamadas abaixo usam o método GET. Substitua SEU_TOKEN pelo token da sua conta e respeite as permissões do seu plano.

GET

Futebol · hoje

Jogos do dia no feed de futebol.

Futebol · hoje
https://apisport.tropatech.com.br/user/ver_json.php?token=SEU_TOKEN&modalidade=futbolhoje
GET

Futebol · amanhã

Programação do dia seguinte no feed de futebol.

Futebol · amanhã
https://apisport.tropatech.com.br/user/ver_json.php?token=SEU_TOKEN&modalidade=futbolamanha
GET

Basquete · NBA

Feed de basquete. O identificador nba também é aceito.

Basquete · NBA
https://apisport.tropatech.com.br/user/ver_json.php?token=SEU_TOKEN&modalidade=basquete
GET

UFC · MMA

Eventos e lutas no feed de UFC.

UFC · MMA
https://apisport.tropatech.com.br/user/ver_json.php?token=SEU_TOKEN&modalidade=ufc

Como interpretar a resposta

Em caso de sucesso, o endpoint entrega o conteúdo JSON do feed, sem adicionar um envelope padrão como status ou data. A estrutura e os campos variam por modalidade. Confira o JSON da sua conta antes de definir o mapeamento do seu aplicativo.

Trate campos ausentes e feeds vazios na interface. Informações de horário, resultado e canal dependem do evento e dos dados disponíveis.

04 / DO EXEMPLO AO SEU PROJETO

Faça sua primeira consulta.

Os exemplos usam o feed de futebol de hoje e tratam erros antes de interpretar o JSON. Nas aplicações de servidor, configure a variável de ambiente TROPA_API_TOKEN com seu token.

cURL
curl --get 'https://apisport.tropatech.com.br/user/ver_json.php' \
  --data-urlencode "token=$TROPA_API_TOKEN" \
  --data-urlencode 'modalidade=futbolhoje' \
  --header 'Accept: application/json' \
  --fail-with-body
JavaScript · Node.js 18+
// Execute no servidor. Não exponha o token no navegador.
const token = process.env.TROPA_API_TOKEN;
if (!token) throw new Error('Configure TROPA_API_TOKEN');

const url = new URL('https://apisport.tropatech.com.br/user/ver_json.php');
url.search = new URLSearchParams({ token, modalidade: 'futbolhoje' });
const response = await fetch(url, { headers: { Accept: 'application/json' } });
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const dados = await response.json();
console.log(dados);
PHP · cURL
<?php
$token = getenv('TROPA_API_TOKEN');
if (!$token) throw new RuntimeException('Configure TROPA_API_TOKEN');
$params = http_build_query(['token' => $token, 'modalidade' => 'futbolhoje']);
$ch = curl_init('https://apisport.tropatech.com.br/user/ver_json.php?' . $params);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($body === false || $status !== 200) throw new RuntimeException(curl_error($ch) ?: "HTTP $status");
$dados = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
curl_close($ch);
Python · requests
import os
import requests
response = requests.get(
    'https://apisport.tropatech.com.br/user/ver_json.php',
    params={'token': os.environ['TROPA_API_TOKEN'], 'modalidade': 'futbolhoje'},
    headers={'Accept': 'application/json'}, timeout=15,
)
response.raise_for_status()
dados = response.json()
05 / DADOS NA SUA HOSPEDAGEM

Conheça o receptor.

O arquivo gerado em “Baixar apicron” recebe os dados da central via POST e salva os JSONs na sua hospedagem. Ele também permite consultar os arquivos locais via GET.

  1. Gere o receptor no painel.Escolha os nomes dos arquivos de hoje, amanhã, UFC e NBA.
  2. Envie o apicron.php para sua hospedagem PHP.A pasta precisa permitir a escrita dos arquivos JSON.
  3. Cadastre a URL para recebimento.Informe o endereço do receptor na configuração de envio da central, conforme as opções liberadas para sua conta.
  4. Aguarde o primeiro envio.Os arquivos ficam disponíveis após a central entregar os dados ao receptor.
Consulta no seu domínioArquivo padrão
apicron.php?tipo=hojejogos.json
apicron.php?tipo=amanhajogosamanha.json
apicron.php?tipo=nbanba.json
apicron.php?tipo=ufcufc.json
VERIFICAR O RECEPTOR
https://SEU_DOMINIO/apicron.php?meta=1
RESPOSTA DE IDENTIFICAÇÃO
{
  "success": true,
  "receiver_version": "v2",
  "supported_types": ["hoje", "amanha", "ufc", "nba"]
}
Parâmetros diferentes para cada integração

O JSON do painel usa token e modalidade. O receptor na sua hospedagem usa tipo. Os exemplos antigos com api e action não correspondem ao receptor atual.

06 / MANTENHA A INTEGRAÇÃO EM DIA

Respostas e limites.

No endpoint /user/ver_json.php, envie Accept: application/json para receber mensagens de erro em texto simples, em vez das páginas HTML de aviso. Verifique o status HTTP antes de chamar o parser JSON.

HTTPSignificadoO que conferir
200Feed entregueLeia e valide o conteúdo JSON.
400Parâmetros inválidosPresença de token e modalidade; identificador correto.
403Acesso não autorizadoToken, assinatura, modalidade e liberação do JSON.
404Feed indisponívelArquivo ainda não disponível no servidor.
429Cota esgotadaLimite de requisições exibido na sua conta.
500Erro no servidorDisponibilidade e leitura dos arquivos do feed.

A cota depende da configuração da assinatura. Consulte o painel para saber o limite e o saldo de requisições. Use cache no seu servidor para evitar chamadas repetidas para cada visitante.

Mensagem do receptor

Antes do primeiro envio, o receptor pode retornar success: false com a mensagem de arquivo não encontrado, mesmo com HTTP 200. Verifique também o conteúdo da resposta.

07 / CATÁLOGO DE IMAGENS

IMG API: jogadores e imagens.

A IMG API entrega em JSON as pastas de jogadores e as imagens ativas do catálogo. Ela usa uma key própria da IMG API, diferente do token da API Sport. Consulte ou copie sua key em IMG API na área do cliente.

Acesso ao catálogo

É necessário ter a IMG API liberada e dentro do vencimento. A assinatura da API Sport e seu token não substituem essa autorização.

GET

Listar o catálogo em JSON

Use sua key pelo parâmetro key ou pelo cabeçalho X-API-Key. A resposta inclui totais, jogadores, URLs individuais e paginação.

URL BASE
https://apisport.tropatech.com.br/api/images.php?key=SEU_IMG_API_KEY
ParâmetroObrigatórioUso
keySim, se não enviar o cabeçalhoKey própria da IMG API, disponível em /user/images.php.
playerNãoFiltra por nome ou slug do jogador, por exemplo neymar.
pageNãoPágina do resultado; começa em 1.
per_pageNãoItens por página; padrão 100, máximo 100.

Limite do catálogo: até 30 consultas por minuto e 120 por hora. O endpoint de imagens permite até 120 imagens por minuto e 300 por hora por conta. Ultrapassar o limite de imagens gera auditoria e reduz temporariamente o acesso para 10 imagens por hora durante 24 horas. A API retorna HTTP 429 e informa o tempo de espera em Retry-After.

GET

Exemplos de consulta

Use o slug da pasta para listar apenas as imagens daquele jogador. A resposta inclui os links individuais das imagens.

UMA PASTA E UMA PÁGINA ESPECÍFICA
https://apisport.tropatech.com.br/api/images.php?key=SEU_IMG_API_KEY&player=neymar&page=1&per_page=100
AUTENTICAÇÃO PELO CABEÇALHO
curl 'https://apisport.tropatech.com.br/api/images.php?player=neymar' \
  --header 'X-API-Key: SEU_IMG_API_KEY' \
  --header 'Accept: application/json'
GET

Buscar uma imagem

Cada item do catálogo contém uma URL de imagem autenticada com o identificador e a key. O endereço público original do armazenamento não é entregue ao navegador.

URL DA IMAGEM
https://apisport.tropatech.com.br/api/player_image.php?id=ID_DA_IMAGEM&key=SEU_IMG_API_KEY
Proteja sua key

A key permite consultar o catálogo e as imagens enquanto sua liberação estiver ativa. Guarde-a no servidor, não a publique em JavaScript ou repositórios, e gere outra pela área do cliente se ela for exposta. Os limites reduzem o volume de downloads automatizados; qualquer imagem que uma conta autorizada consegue exibir ainda pode ser salva por essa conta.

TROPA DEVELOPERS

Pronto para entrar em jogo?

Encontre suas credenciais e os feeds liberados na área do cliente.

Entrar na minha conta ↗