Api Integration

Padrão de Client HTTP Resiliente

O client em src/data/api_client.py deve seguir:

Retry com backoff exponencial

import time
import requests

def fetch_with_retry(url: str, headers: dict, max_retries: int = 3) -> dict:
    for attempt in range(max_retries):
        response = requests.get(url, headers=headers, timeout=30)
        if response.status_code == 200:
            return response.json()
        if response.status_code == 429:  # Rate limit
            wait = 2 ** attempt
            time.sleep(wait)
            continue
        response.raise_for_status()
    raise RuntimeError(f"Falha após {max_retries} tentativas: {url}")

Cache local com TTL

• Armazenar respostas em data/cache/ como JSON
• TTL configurável (default: 1h para dados ao vivo, 24h para histórico)
• Verificar cache antes de cada request

Endpoints Principais — Sportmonks

Header de autenticação: Authorization: {token}

Schema de Chaves Compostas

Para evitar fragmentação de IDs entre clubes e seleções:

PRIMARY KEY (player_id, team_id, season, competition)

Sempre usar chave composta ao armazenar/consultar dados de jogadores.

Referências

• Arquitetura detalhada: docs/arquitetura-api.md
• Client implementation: src/data/api_client.py
• Data loader: src/data/data_loader.py