POST /ipulse/scoreboard

Retorna o placar do dia e do dia seguinte para uma competição de futebol, com dados em tempo real via Sportmonks.

Consulte a Visão Geral do IPulse para entender autenticação e ligas disponíveis.

Autenticação

Requer header ifw-ipulse-key com a API key fixa configurada no ambiente.

Header	Valor
ifw-ipulse-key	<api_key>

Request

Query Parameters

Parâmetro	Tipo	Obrigatório	Descrição
leagueId	int	—	ID da liga no Sportmonks. Padrão: 648 (Campeonato Brasileiro Série A)
referenceDate	datetime	—	Data de referência. Padrão: hoje

curl -s -X POST "https://servicos.ifollowtech.com.br/ipulse/scoreboard?leagueId=648" \
  -H "ifw-ipulse-key: SUA_API_KEY"

Response

200 OK

{
  "ShortMessage": "SCOREBOARD",
  "Response": {
    "competition": {
      "name": "Campeonato Brasileiro Série A",
      "series": "2025",
      "stage": "REGULAR_SEASON",
      "round": "Rodada 12",
      "logo": "https://cdn.sportmonks.com/images/soccer/leagues/648.png"
    },
    "today": {
      "date": "2025-05-04",
      "scoreboard": {
        "update_required": true,
        "games_today": [
          {
            "match_id": "19082541",
            "scheduled_at": "2025-05-04T18:00:00Z",
            "scheduled_date": "2025-05-04",
            "scheduled_time": "18:00",
            "home_team": {
              "id": 2456,
              "name": "Flamengo",
              "logo": "https://cdn.sportmonks.com/images/soccer/teams/8/2456.png"
            },
            "away_team": {
              "id": 2450,
              "name": "Palmeiras",
              "logo": "https://cdn.sportmonks.com/images/soccer/teams/2/2450.png"
            },
            "home_score": 1,
            "away_score": 0,
            "status": "IN_PROGRESS",
            "minute": 67,
            "progress_percentage": 74
          }
        ]
      }
    },
    "tomorrow": {
      "date": "2025-05-05",
      "scoreboard": {
        "update_required": false,
        "games_today": []
      }
    },
    "metadata": {
      "source": "sportmonks",
      "region": "BR",
      "last_update": "2025-05-04T18:22:00Z"
    }
  },
  "Messages": [],
  "HttpStatusCode": 200
}

Descrição dos campos de resposta

competition

Campo	Tipo	Descrição
name	string	Nome da competição (PT-BR quando disponível)
series	string	Nome da temporada/série
stage	string	Fase da competição em código (ver tabela de fases abaixo)
stage_name_pt	string	Nome da fase em português (ex: "Quartas de Final")
round	string	Rodada atual
logo	string	URL do logo da competição

Fases da competição (stage)

Valor	stage_name_pt
REGULAR_SEASON	Temporada Regular
GROUP_STAGE	Fase de Grupos
ROUND_OF_32	Fase de 32
ROUND_OF_16	Oitavas de Final
QUARTER_FINALS	Quartas de Final
SEMI_FINALS	Semifinais
THIRD_PLACE_FINAL	Disputa de 3º Lugar
FINAL	Final
PLAY_OFFS	Playoffs
QUALIFICATION	Classificatória
PRELIMINARY_ROUND	Rodada Preliminar
UNKNOWN	Fase não identificada

today / tomorrow

Campo	Tipo	Descrição
date	string	Data no formato yyyy-MM-dd
scoreboard.update_required	boolean	true se houver partidas em andamento — indica que o cliente deve atualizar periodicamente
scoreboard.games_today	array	Lista de partidas ordenadas por status → horário → id

Partida (games_today[])

Campo	Tipo	Descrição
match_id	string	ID da partida no Sportmonks
scheduled_at	string	Data e hora UTC completa (yyyy-MM-ddTHH:mm:ssZ)
scheduled_date	string	Data no formato yyyy-MM-dd
scheduled_time	string	Hora no formato HH:mm (UTC)
home_team.id	int	ID do time mandante
home_team.name	string	Nome do time mandante
home_team.logo	string	URL do escudo do time mandante
away_team.*	—	Mesmo padrão do home_team
home_score	int	Gols do time mandante
away_score	int	Gols do time visitante
status	string	Status da partida (ver tabela abaixo)
minute	int	Minuto atual da partida (0 se não iniciada)
progress_percentage	int	Percentual de progresso de 0 a 100

Status possíveis

Valor	Descrição
SCHEDULED	Partida não iniciada
IN_PROGRESS	Partida em andamento
FINISHED	Partida encerrada
POSTPONED	Partida adiada
CANCELLED	Partida cancelada
ABANDONED	Partida abandonada
SUSPENDED	Partida suspensa
UNKNOWN	Status não mapeado — tratar como indisponível

401 Unauthorized

Header ifw-ipulse-key ausente ou inválido.

503 Service Unavailable

Variável de ambiente IPULSE_API_KEY não configurada no servidor.