Documentação da API
Referência completa de todos os endpoints disponíveis
URL Base:
https://magosport.com.br/api/v1
Introdução
A MagoSport fornece acesso em tempo real a placares, odds, estatísticas e notícias esportivas via API RESTful. Todos os endpoints retornam JSON.
Esportes suportados: Futebol (30+ ligas), Basquete (NBA), Futebol Americano (NFL), Hockey (NHL), Baseball (MLB).
Autenticação
Todas as requisições precisam de uma API Key válida. Você pode obtê-la no seu Dashboard.
Formas de autenticar
# Via header (recomendado)
curl -H "X-API-Key: sua_api_key" https://magosport.com.br/api/v1/scoreboard/soccer
# Via query string
curl "https://magosport.com.br/api/v1/scoreboard/soccer?api_key=sua_api_key"
# Via Authorization Bearer
curl -H "Authorization: Bearer sua_api_key" https://magosport.com.br/api/v1/scoreboard/soccer
Rate Limiting
Os limites variam por plano. Os headers abaixo são retornados em cada resposta:
Headers de Rate Limit
X-RateLimit-Limit: 500 # Limite do seu plano (req/hora)
X-RateLimit-Remaining: 487 # Requisições restantes nesta hora
Retry-After: 60 # Segundos para aguardar (apenas no 429)
Códigos de Erro
| Código | Tipo | Descrição |
|---|---|---|
| 401 | Unauthorized | API Key ausente ou inválida |
| 403 | Forbidden | Conta suspensa |
| 404 | Not Found | Endpoint não encontrado |
| 429 | Too Many Requests | Rate limit excedido |
| 500 | Server Error | Erro interno |
GET /leagues
GET
/v1/leagues
Lista todos os esportes e ligas disponíveis
🔒 Requer autenticação: X-API-Key
Exemplo
curl -H "X-API-Key: SUA_KEY" https://magosport.com.br/api/v1/leagues
GET
/v1/scoreboard/{sport}
Busca placares de um esporte. sport: soccer, basketball, football, hockey, baseball
🔒 Requer autenticação: X-API-Key
Parâmetros de Rota
| Parâmetro | Tipo | Descrição | Obrigatorio |
|---|---|---|---|
| sport | string | soccer, basketball, football, hockey, baseball | Sim |
Query Parameters
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| date | string | Data no formato YYYYMMDD (padrão: hoje) | Não |
| status | string | Filtro: live, pre, post | Não |
| league | string | ID da liga (para futebol) | Não |
Exemplo
curl -H "X-API-Key: SUA_KEY" https://magosport.com.br/api/v1/scoreboard/soccer?league=bra.1
GET
/v1/odds/{sport}/{league}
Retorna odds de apostas com 9 mercados disponíveis
🔒 Requer autenticação: X-API-Key
Parâmetros de Rota
| Parâmetro | Tipo | Descrição | Obrigatorio |
|---|---|---|---|
| sport | string | Ex: soccer | Sim |
| league | string | Ex: bra.1 | Sim |
Query Parameters
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| market | string | Mercado: result_1x2, moneyline, totals, handicap, both_teams_score, double_chance | Não |
Exemplo
curl -H "X-API-Key: SUA_KEY" https://magosport.com.br/api/v1/odds/soccer/bra.1?market=totals
GET
/v1/games/{sport}/{gameId}
Detalhes e estatísticas de uma partida específica
🔒 Requer autenticação: X-API-Key
Parâmetros de Rota
| Parâmetro | Tipo | Descrição | Obrigatorio |
|---|---|---|---|
| sport | string | Ex: soccer | Sim |
| gameId | string | ID da partida (obtido do scoreboard) | Sim |
Query Parameters
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| stats | path | Adicione /stats para box score detalhado | Não |
Exemplo
curl -H "X-API-Key: SUA_KEY" https://magosport.com.br/api/v1/games/soccer/401234
GET
/v1/news/{sport}
Notícias esportivas em tempo real
🔒 Requer autenticação: X-API-Key
Parâmetros de Rota
| Parâmetro | Tipo | Descrição | Obrigatorio |
|---|---|---|---|
| sport | string | Ex: soccer | Sim |
Query Parameters
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| limit | integer | Número de artigos (máx 50, padrão 10) | Não |
Exemplo
curl -H "X-API-Key: SUA_KEY" https://magosport.com.br/api/v1/news/soccer?limit=5
GET
/v1/teams/{sport}
Lista todos os times de um esporte
🔒 Requer autenticação: X-API-Key
Parâmetros de Rota
| Parâmetro | Tipo | Descrição | Obrigatorio |
|---|---|---|---|
| sport | string | Ex: basketball | Sim |
Query Parameters
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| teamId | path | ID do time para detalhes específicos | Não |
Exemplo
curl -H "X-API-Key: SUA_KEY" https://magosport.com.br/api/v1/teams/basketball
GET
/v1/markets
Lista todos os mercados de apostas disponíveis
🔒 Requer autenticação: X-API-Key
Exemplo
curl -H "X-API-Key: SUA_KEY" https://magosport.com.br/api/v1/markets