📚 DOCUMENTAÇÃO API

Guia completo para integração com as APIs esportivas da TROPA APIS

📑 Navegação Rápida

Introdução Autenticação Endpoints API Futebol API NBA API UFC API Live Sport Códigos de Erro Exemplos de Código

🚀 Introdução

A TROPA APIS oferece acesso a dados esportivos em tempo real através de APIs RESTful. Todas as respostas são retornadas em formato JSON e utilizam autenticação baseada em token.

💡 Base URL:
https://api.techduckdev.top/apisport/apijson.php

✨ Recursos Disponíveis

⚽ Futebol - Jogos, estatísticas e odds 🏀 NBA - Partidas e rankings 🥊 UFC - Lutas e lutadores 📺 Live Sport - Transmissões M3U8

🔐 Autenticação

Todas as requisições devem incluir seu token de autenticação e devem ser feitas a partir do domínio registrado.

⚠️ Importante: As requisições só funcionam quando feitas através do arquivo apicron.php hospedado no seu domínio registrado. Requisições diretas serão bloqueadas.

🔑 Obtendo seu Token

  1. Faça login no Dashboard
  2. Copie seu token único na seção "Suas Credenciais"
  3. Registre o domínio onde a API será utilizada
  4. Baixe o arquivo apicron.php personalizado
<?php
$api_url = "https://seudominio.com/apicron.php";
$params = [
    'api' => 'futbol',
    'action' => 'jogos_hoje'
];

$url = $api_url . '?' . http_build_query($params);
$response = file_get_contents($url);
$data = json_decode($response, true);
?>

🌐 Endpoints Principais

⚽ API Futebol

GET apicron.php?api=futbol&action=jogos_hoje

Retorna todos os jogos de futebol do dia atual.

Parâmetros:

Parâmetro Tipo Obrigatório Descrição
api string Sim Deve ser "futbol"
action string Sim Ação desejada

Resposta de Sucesso:

{
  "status": "success",
  "data": [
    {
      "id": 12345,
      "time_casa": "Flamengo",
      "time_fora": "Palmeiras",
      "placar_casa": 2,
      "placar_fora": 1,
      "status": "ao_vivo",
      "tempo": "65'",
      "campeonato": "Brasileirão Série A"
    }
  ],
  "total": 15
}

🏀 API NBA

GET apicron.php?api=nba&action=partidas_hoje

Retorna todas as partidas de NBA do dia.

Resposta de Sucesso:

{
  "status": "success",
  "data": [
    {
      "id": 67890,
      "time_casa": "Lakers",
      "time_fora": "Warriors",
      "placar_casa": 105,
      "placar_fora": 98,
      "status": "finalizado",
      "quarter": "4Q"
    }
  ]
}

🥊 API UFC

GET apicron.php?api=ufc&action=proximas_lutas

Retorna as próximas lutas agendadas.

Resposta de Sucesso:

{
  "status": "success",
  "data": [
    {
      "id": 11223,
      "lutador_1": "Jon Jones",
      "lutador_2": "Stipe Miocic",
      "categoria": "Peso Pesado",
      "data": "2024-12-15",
      "evento": "UFC 300"
    }
  ]
}

📺 API Live Sport

GET apicron.php?api=live_sport&action=canais

Retorna lista de canais esportivos disponíveis em formato M3U8.

Resposta de Sucesso:

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "nome": "ESPN Brasil",
      "url_m3u8": "https://...",
      "qualidade": "HD",
      "idioma": "pt-BR"
    }
  ]
}

⚠️ Códigos de Erro

Código Mensagem Descrição
401 Unauthorized Token inválido ou ausente
403 Forbidden Domínio não autorizado
404 Not Found Endpoint não encontrado
429 Too Many Requests Limite excedido
500 Internal Server Error Erro interno

Exemplo de Resposta de Erro:

{
  "status": "error",
  "code": 403,
  "message": "Domínio não autorizado",
  "details": "Registre seu domínio no painel"
}

💻 Exemplos de Código

PHP

<?php
$api_url = "https://seudominio.com/apicron.php";
$params = [
    'api' => 'futbol',
    'action' => 'jogos_hoje'
];

$url = $api_url . '?' . http_build_query($params);
$response = file_get_contents($url);
$data = json_decode($response, true);

if ($data['status'] === 'success') {
    foreach ($data['data'] as $jogo) {
        echo "{$jogo['time_casa']} vs {$jogo['time_fora']}\n";
    }
}
?>

JavaScript (Fetch)

const apiUrl = 'https://seudominio.com/apicron.php';
const params = new URLSearchParams({
    api: 'nba',
    action: 'partidas_hoje'
});

fetch(`${apiUrl}?${params}`)
    .then(response => response.json())
    .then(data => {
        if (data.status === 'success') {
            data.data.forEach(partida => {
                console.log(`${partida.time_casa} vs ${partida.time_fora}`);
            });
        }
    })
    .catch(error => console.error('Erro:', error));

Python

import requests

api_url = "https://seudominio.com/apicron.php"
params = {
    'api': 'ufc',
    'action': 'proximas_lutas'
}

response = requests.get(api_url, params=params)
data = response.json()

if data['status'] == 'success':
    for luta in data['data']:
        print(f"{luta['lutador_1']} vs {luta['lutador_2']}")

cURL

curl -X GET "https://seudominio.com/apicron.php?api=futbol&action=jogos_hoje" \
     -H "Accept: application/json"

🚀 Pronto para Começar?

Crie sua conta e comece a usar nossas APIs agora mesmo!

Criar Conta Grátis