Você precisa mostrar aos usuários uma lista limpa de competições (por esporte e país) e integrá-la ao seu aplicativo esta semana. Ao final deste guia, você chamará um endpoint de produção que retorna metadados da competição (IDs, nomes, URLs, bandeiras como hasStandings e hasStats), fará o parsing e integrará ao seu fluxo de trabalho de UI ou backend.
O que você construirá com a API 365Scores
A API 365Scores no Zyla API Hub retorna dados esportivos estruturados que seu aplicativo pode consumir imediatamente. Para descoberta de competições, você usará um endpoint que busca competições para um determinado esporte e país, incluindo identificadores que você precisará para direcionar os usuários para classificações, jogos ou estatísticas em outras partes do seu sistema.
Usos típicos incluem:
- Seletores de país e liga em fluxos de integração.
- Utilitários administrativos para mapear IDs de competições para modelos de conteúdo internos.
- Aquecedores de cache ou trabalhos CRON para atualizar a lista ativa de competições diariamente.
Começando no Zyla API Hub
Abra a lista de APIs, inscreva-se e obtenha sua chave:
- Visite a página da API 365Scores no Zyla API Hub e clique em Inscrever-se ou Começar Teste Gratuito.
- Copie sua chave da API no painel. Todas as solicitações usam Authorization: Bearer YOUR_API_KEY.
- Faça sua primeira chamada contra o endpoint de competição abaixo.
O Zyla API Hub agrega mais de 10.000 APIs públicas sob uma conta e uma chave. O uso é cobrado por meio de uma assinatura com cotas (não é pay-per-call). Para esta API, você pode iniciar um teste de 7 dias a partir da página de listagem: Comece o teste de 7 dias na API 365Scores.
Endpoint: Obter competições (por esporte e país)
Este endpoint retorna dados de competição filtrados por esporte e país. Você usará os IDs na sua UI e armazenará os nomes/bandeiras para decidir o que renderizar (por exemplo, se uma liga tem classificações ou estatísticas).
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29728/get-competitions
- Parâmetros de consulta obrigatórios:
- sportId
- countryId
- langId
- timezone
- Autenticação: Authorization: Bearer YOUR_API_KEY
cURL que você pode copiar/colar
curl -s -X GET "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions?sportId=1&countryId=11&langId=1&timezone=Europe%2FBerlin" \
-H "Authorization: Bearer YOUR_API_KEY"
Resposta JSON oficial
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…
Campos que você realmente usará
- competitions[].id: Chave primária que você armazenará e passará pelo seu sistema.
- competitions[].name e longName: Strings de exibição para rótulos de UI.
- competitions[].hasStandings, hasStats, hasTransfers: Controlam condicionalmente os recursos da UI.
- competitions[].currentSeasonNum e currentStageNum: Contexto para visualizações cientes da temporada.
- competitions[].nameForURL: Útil para URLs ou slugs bonitos.
- sports[0] e countries[0]: Confirmam o escopo que você solicitou (por exemplo, futebol em Portugal).
Nota sobre fusos horários: a solicitação inclui timezone=Europe/Berlin. Mantenha-o consistente em suas chamadas para que quaisquer campos de data/hora subsequentes que você encontrar em endpoints relacionados permaneçam alinhados. O exemplo acima não inclui timestamps, mas usar uma string de fuso horário estável é uma boa prática em toda a sua integração.
Exemplo em Python: buscar e filtrar competições ativas
O trecho abaixo chama o mesmo endpoint, aplica o cabeçalho de Autorização e filtra competições inativas antes de imprimir um payload compacto que você pode passar para um frontend.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions"
params = {
"sportId": "1",
"countryId": "11",
"langId": "1",
"timezone": "Europe/Berlin"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
competitions = data.get("competitions", [])
active = [c for c in competitions if c.get("isActive")]
# Forma mínima para sua UI
result = [
{
"id": c["id"],
"name": c.get("name") or c.get("longName"),
"slug": c.get("nameForURL"),
"hasStandings": c.get("hasStandings"),
"hasStats": c.get("hasStats"),
"season": c.get("currentSeasonNum"),
"stage": c.get("currentStageNum")
}
for c in active
]
print({
"sport": (data.get("sports") or [{}])[0].get("name"),
"country": (data.get("countries") or [{}])[0].get("name"),
"count": len(result),
"competitions": result[:5] # prévia dos 5 principais
})
Notas de implementação que economizam tempo
- IDs são chaves estáveis: armazene competitions[].id como sua referência canônica. Nomes podem mudar entre temporadas; slugs (nameForURL) são úteis, mas não são chaves primárias.
- Flags de recursos: hasStandings, hasStats, hasTransfers permitem que você oculte ou mostre abas sem sondar endpoints adicionais.
- Cache: listas de competições em nível de país não mudam minuto a minuto. Armazene em cache por horas e invalide quando você implantar ou em uma programação diária.
- Localização: use langId consistentemente para o idioma do cliente. Se você suportar vários locais, armazene resultados por (sportId, countryId, langId).
- Fusos horários: mantenha o fuso horário consistente em seu aplicativo para evitar diferenças sutis em datas derivadas. Europe/Berlin é usado no exemplo; escolha uma estratégia e mantenha-se fiel a ela.
Passo a passo: integrando detalhes da competição ao seu aplicativo
1) Decida seu escopo
Escolha sportId e countryId para o escopo de lançamento do seu produto. No exemplo acima, sportId=1 (Futebol) e countryId=11 (Portugal). Você pode consultar diferentes países ou esportes alterando esses IDs conforme necessário em sua integração.
2) Chame o endpoint do lado do servidor
Envie o cabeçalho Authorization: Bearer de um backend seguro. Evite expor YOUR_API_KEY no código do lado do cliente. A resposta inclui arrays de esportes, países e competições, que você pode mapear para o modelo da sua página.
3) Normalize e armazene
Persistir id, nome, slug e flags da competição. A maioria das equipes armazena uma linha mínima além do JSON bruto para depuração.
4) Renderize sua UI
Mostre um seletor de país e liga populado a partir do seu cache. Renderize condicionalmente abas usando as flags (por exemplo, mostre uma aba “Classificações” apenas quando hasStandings for verdadeiro).
5) Atualize em uma programação
Reconstrua seu cache em uma cadência que se ajuste ao seu caso de uso (por exemplo, diariamente). Acompanhe a última atualização nos metadados para que você possa solucionar rapidamente se uma lista de ligas parecer desatualizada.
Endpoints relacionados que você pode usar a seguir
Se sua visualização de competição também vincula a páginas focadas em jogadores, esses endpoints retornam detalhes de jogadores, partidas e estatísticas. Eles são separados da descoberta de competições, mas muitas vezes aparecem juntos nas mesmas áreas de produto.
Obter detalhes do jogador
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29748/get-player-details
- Parâmetros: playerId, langId, timezone
{
"sports": [
{
"id": 1,
"name": "Futebol",
"nameForURL": "futebol",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Primeira Liga Portuguesa",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Classificações",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Classificações",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…
Obter partidas do jogador
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29749/get-player-matches
- Parâmetros: playerId, langId, timezone
Obter estatísticas do jogador
- Método: GET
- URL: https://zylalabs.com/api/13503/365scores-api/29750/get-player-stats
- Parâmetros: playerId, langId, timezone
Chamando a API de um agente de IA via MCP
Qualquer API no Zyla pode ser chamada de clientes compatíveis com MCP (Claude Code, Cursor, Windsurf, etc.). Aponte seu agente para o endpoint MCP e forneça sua chave como um parâmetro de consulta ao configurar o host da ferramenta: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Uma vez configurado, seu agente pode invocar o mesmo endpoint de competição que você viu acima com os parâmetros necessários. Para documentação sobre o MCP em si, veja: MCP.
Armadilhas comuns e solução de problemas
- Erros 401: Certifique-se de que o cabeçalho Authorization seja exatamente Authorization: Bearer YOUR_API_KEY sem espaços ou esquemas extras.
- Array de competições vazio: Verifique se sportId e countryId são válidos para seu escopo. Tente um par diferente se sua combinação inicial não estiver retornando ligas.
- Desajuste de localização: Se sua UI estiver em um idioma específico, mantenha langId consistente em todas as chamadas. Armazene resultados por idioma.
- Diferenças de fuso horário: Padronize o fuso horário no nível da aplicação para evitar comportamentos mistos de UTC/local quando você adicionar outros endpoints mais tarde.
Padrões de integração do mundo real
- Menus renderizados no servidor: Ao iniciar o aplicativo, busque competições e renderize um dropdown de ligas por país. Armazene apenas id, nome, slug e as flags de recurso.
- Ingestão em lote: Trabalho noturno itera os países que você suporta e atualiza os dados de competição em seu banco de dados ou loja KV.
- Páginas com recursos restritos: Não vincule a classificações ou estatísticas se as flags da API para uma liga disserem que esses recursos não estão disponíveis (hasStandings, hasStats).
- Links profundos: Use nameForURL para construir slugs legíveis por humanos enquanto roteia pelo id numérico nos bastidores.
FAQ
Posso mudar o esporte e o país?
Sim. Passe o sportId e countryId apropriados na string de consulta. O exemplo usa Futebol em Portugal; atualize os IDs para corresponder ao seu escopo.
Preciso enviar uma chave de API em cada solicitação?
Sim. Inclua Authorization: Bearer YOUR_API_KEY em cada chamada do seu código do lado do servidor.
Com que frequência devo atualizar a lista de competições?
As listas de competições não mudam minuto a minuto. A maioria das equipes armazena em cache por horas ou atualiza diariamente. Escolha uma cadência alinhada com as necessidades do seu produto.
E se eu precisar de páginas de jogadores vinculadas a uma visualização de competição?
Use os endpoints de jogador mostrados acima (detalhes, partidas, estatísticas) para preencher páginas ou modais específicos de jogadores. Eles são chamadas separadas da descoberta de competições.
Há um plano gratuito?
As opções de acesso podem mudar. Verifique a página da API para opções de acesso e preços atuais. Você pode iniciar um teste de 7 dias a partir da listagem do marketplace.
Pronto para enviar detalhes da competição? Inscreva-se e obtenha sua chave na listagem da API 365Scores no Zyla API Hub: Comece o teste de 7 dias na API 365Scores. Em seguida, insira o exemplo de cURL ou Python no seu backend, armazene os resultados em cache e ilumine sua UI.
Resposta oficial da API
{
"sports": [
{
"id": 1,
"name": "Futebol",
"nameForURL": "futebol",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Primeira Liga Portuguesa",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Classificações",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Classificações",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…