IPulse
O IPulse é o módulo de dados esportivos em tempo real da plataforma IFW. Ele consome a API do Sportmonks e expõe endpoints prontos para uso por clientes externos via API key dedicada.
O que está disponível
| Endpoint | Descrição |
|---|---|
POST /ipulse/scoreboard | Placares do dia e do dia seguinte para uma liga de futebol |
Autenticação
Os endpoints IPulse usam API key estática — diferente do fluxo OAuth/JWT usado pelos endpoints de negócio.
Envie a chave no header ifw-ipulse-key em todas as requisições:
curl -s -X POST "https://servicos.ifollowtech.com.br/ipulse/scoreboard" \
-H "ifw-ipulse-key: SUA_API_KEY"
| Header | Obrigatório | Descrição |
|---|---|---|
ifw-ipulse-key | ✅ | API key fornecida pela IFW |
A chave é configurada via variável de ambiente IPULSE_API_KEY no servidor. Requisições a endpoints IPulse retornarão 503 Service Unavailable se a variável não estiver definida no ambiente.
Fonte de dados
Todos os dados são obtidos em tempo real via Sportmonks Football API. O campo metadata.source na resposta sempre retorna "sportmonks" e metadata.region retorna "BR".
Ligas suportadas
Qualquer liga disponível no Sportmonks pode ser consultada via leagueId. A liga padrão quando o parâmetro é omitido é:
| ID | Liga |
|---|---|
648 | Campeonato Brasileiro Série A |
Códigos de resposta comuns
| Código | Situação |
|---|---|
200 OK | Dados retornados com sucesso |
401 Unauthorized | Header ifw-ipulse-key ausente ou inválido |
503 Service Unavailable | Variável de ambiente IPULSE_API_KEY não configurada |
500 Internal Server Error | Falha ao comunicar com o Sportmonks ou erro interno |