Você precisa de uma API para listar os arquivos que você tem permissão para ler, verificar se um arquivo alvo existe e, em seguida, puxá-lo sem adivinhar nomes ou caminhos. Ao final deste artigo, você chamará um verdadeiro endpoint de "listar arquivos", analisará sua resposta e buscará um dos arquivos que ele retorna—de forma limpa, com semânticas de cache que você pode integrar na produção esta semana.
O que esta API faz
A API de Odds da Fonbet no Zyla API Hub expõe acesso orientado a arquivos para instantâneas de odds de casas de apostas. Ela oferece:
- Um endpoint de listagem de arquivos que retorna o conjunto exato de arquivos de odds que sua assinatura pode ler, ordenados por nome. Você chama isso primeiro e trabalha apenas com os nomes que ele fornece.
- Um endpoint para buscar um desses arquivos, retornado em um envelope com metadados e o JSON original da casa de apostas inalterado.
Este é um fluxo de trabalho de gerenciamento de arquivos: descobrir arquivos disponíveis, selecionar um pelo nome e baixá-lo. É adequado para agilizar trabalhos de ingestão, verificar acesso antes de agendar pulls e manter seu pipeline de odds resiliente.
Começando no Zyla API Hub
Abra a página da API para a API de Odds da Fonbet, clique em Assinar ou Iniciar Teste Gratuito se disponível, e pegue sua chave de API. A autenticação é um único cabeçalho que você adiciona às requisições. O Zyla API Hub usa um modelo de assinatura + cota (não é pago por chamada). A primeira API na sua conta pode oferecer um teste de 7 dias ou 50 requisições; sempre verifique a página da API para opções de acesso e preços atuais.
Você pode navegar por milhares de APIs prontas para produção no Zyla API Hub, todas sob uma conta e uma chave de API. Quando você estiver pronto para testar esta API específica, use o link de listagem abaixo.
Os endpoints que você usará
Base: Todas as chamadas vão para os URLs do Hub do Zyla mostrados abaixo. Não adicione parâmetros de consulta a menos que estejam documentados. A autenticação é necessária via Authorization: Bearer YOUR_API_KEY.
1) Listar Arquivos
- Método: GET
- URL: https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
- Descrição: Lista os arquivos de odds que sua assinatura pode ler, ordenados por nome. Retorna empresa, contagem e arquivos (um array de nomes de arquivos). Chame isso primeiro e solicite apenas os nomes que ele retorna.
- Parâmetros: Nenhum documentado.
cURL (copiar/colar):
curl -s -X GET "https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files" \
-H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta oficial:
{
"company": "fonbet",
"count": 1,
"files": [
"site_livepre_fonbet.json"
]
}
O que você realmente usará:
- company: String identificando o provedor de dados (aqui, "fonbet").
- count: Número de arquivos que sua assinatura atual pode acessar.
- files: Array de nomes de arquivos. Estes são os únicos inputs válidos que você deve tentar buscar.
2) Obter Dados
- Método: GET
- URL: https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
- Descrição: Retorna um arquivo de odds dentro de um envelope: {"company", "file", "updated_at", "data"}. O campo de dados contém o JSON original da casa de apostas, inalterado. updated_at é o último horário de atualização (UTC). O mesmo horário é fornecido via o cabeçalho Last-Modified; envie-o de volta via If-Modified-Since para receber um 304 quando nada mudar.
- Parâmetros: Nenhum documentado.
cURL:
Exemplo de resposta (envelope com JSON de odds bruto em dados):
Pontos-chave para uso em produção:
- updated_at é UTC. Trate-o como seu relógio canônico para verificações de obsolescência.
- Use cabeçalhos de cache HTTP: em cada GET bem-sucedido, leia Last-Modified; envie-o de volta como If-Modified-Since em requisições subsequentes para evitar downloads desnecessários quando os dados não mudaram.
- O JSON da casa de apostas sob dados é não modificado; a forma pode ser grande e aninhada, então analise apenas o que você precisa.
Exemplo de ponta a ponta: descobrir e buscar um arquivo
Esboço do fluxo de trabalho:
- Chame Listar Arquivos para descobrir os nomes de arquivos permitidos.
- Escolha o arquivo que você precisa de files[].
- Chame Obter Dados para recuperar o envelope com o JSON de odds bruto.
- Armazene updated_at e o cabeçalho Last-Modified para futuras requisições condicionais.
Exemplo em Python
Este script lista arquivos, seleciona o primeiro nome de arquivo, busca-o e imprime metadados básicos. Ele também demonstra a leitura de Last-Modified para conectar requisições condicionais posteriormente.
import os
import sys
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY")
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
LIST_URL = "https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files"
GET_URL = "https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data"
def list_files():
r = requests.get(LIST_URL, headers=HEADERS, timeout=30)
r.raise_for_status()
return r.json()
def get_data(if_modified_since=None):
headers = HEADERS.copy()
if if_modified_since:
headers["If-Modified-Since"] = if_modified_since
r = requests.get(GET_URL, headers=headers, timeout=60)
if r.status_code == 304:
return {"status": 304, "last_modified": if_modified_since, "body": None}
r.raise_for_status()
return {
"status": r.status_code,
"last_modified": r.headers.get("Last-Modified"),
"body": r.json()
}
def main():
listing = list_files()
print(f"Empresa: {listing.get('company')}")
print(f"Contagem de arquivos: {listing.get('count')}")
files = listing.get("files", [])
if not files:
print("Nenhum arquivo disponível para esta assinatura.")
sys.exit(0)
target = files[0]
print(f"Buscando: {target} via endpoint Obter Dados")
# Primeiro fetch
result = get_data()
print(f"HTTP: {result['status']}, Last-Modified: {result['last_modified']}")
if result["body"]:
env = result["body"]
print(f"Envelope: company={env.get('company')}, file={env.get('file')}, updated_at={env.get('updated_at')}")
# O JSON bruto da casa de apostas está em env['data']; evite imprimir cargas enormes em produção.
# Exemplo de requisição condicional usando Last-Modified
if result["last_modified"]:
result2 = get_data(if_modified_since=result["last_modified"])
print(f"Fetch condicional -> HTTP: {result2['status']} (304 significa inalterado)")
if __name__ == "__main__":
main()
Notas:
- O endpoint Listar Arquivos não documenta parâmetros de requisição—não adicione nenhum.
- O endpoint Obter Dados também não documenta parâmetros; ele retornará o arquivo permitido dentro de seu envelope padrão.
- Use timeouts que façam sentido para seu ambiente e registre Last-Modified para execuções incrementais.
Detalhes de integração prática que economizam tempo
- Autenticação: Sempre envie Authorization: Bearer YOUR_API_KEY.
- Nomes de arquivos: Trate files[] de Listar Arquivos como a fonte da verdade. Não codifique nomes fora do que a API retorna.
- Ordenação: A lista é ordenada por nome. Se você espera apenas um, afirme count == 1 para falhar rapidamente quando sua assinatura mudar.
- Carimbos de data/hora: updated_at é uma string ISO 8601 UTC (por exemplo, 2026-09-27T18:24:34Z). Armazene-a junto com seu lote de ingestão para auditoria.
- Cache: Respeite Last-Modified/If-Modified-Since para minimizar largura de banda e processamento. Um 304 significa que você pode reutilizar sua última instantânea.
- Paginação: Não documentada em Listar Arquivos; codifique como se a lista coubesse em uma página. Se sua assinatura crescer, verifique novamente a documentação na página da API.
- Volume de dados: dados são o JSON original da casa de apostas. Ele pode ser considerável; faça streaming para o disco ou analise seletivamente.
- Tratamento de erros: Trate 401/403 para problemas de autenticação/assinatura e 304 para acertos de cache. Respostas não 200 devem ser re-tentadas conscientemente.
- Ambiente: Mantenha a chave da API fora do controle de versão. Parametrize timeouts e backoff.
- Implantação: Execute Listar Arquivos na inicialização ou em um cronograma para detectar mudanças em arquivos acessíveis antes de buscar.
Casos de uso do mundo real
- Bootstrap ETL: Use Listar Arquivos para validar o acesso no início de um trabalho, busque o único arquivo ao vivo, anexe updated_at e Last-Modified aos metadados do seu trabalho e envie odds analisados para seu armazenamento.
- Sincronizações incrementais: Em um timer, chame Obter Dados com If-Modified-Since. Se 304, pule; se 200, processe diffs mínimos com base em updated_at.
- Monitoramento de acesso: Alerta quando a contagem ou os nomes de arquivos de Listar Arquivos mudam (por exemplo, um arquivo foi adicionado/removido para seu plano).
- Aquecimento de cache: Pré-busque durante a implantação usando Listar Arquivos para escolher alvos, depois Obter Dados para aquecer caches antes do tráfego do usuário.
Chamando de agentes de IA via MCP
Toda API no Zyla pode ser chamada por agentes de IA através do endpoint MCP. Aponte seu cliente compatível com MCP (por exemplo, Claude Code, Cursor, Windsurf) para o gateway MCP e passe sua chave de API do Zyla. Seu agente pode então invocar os mesmos URLs do Hub mostrados acima usando o mesmo cabeçalho de Autorização.
Documentos e endpoint: MCP
Fluxo típico dentro de um agente:
- Passo da ferramenta 1: GET o URL Listar Arquivos com seu cabeçalho de Autorização; analise files[].
- Passo da ferramenta 2: GET o URL Obter Dados; se Last-Modified estiver presente, armazene em cache e reutilize via If-Modified-Since.
Se sua equipe gerencia várias APIs através do Zyla, o MCP centraliza o acesso sob uma chave e uma camada de integração. Você pode explorar mais opções no Zyla API Hub.
Referências prontas para copiar
Listar Arquivos
GET https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
Cabeçalhos:
- Authorization: Bearer YOUR_API_KEY
Retorna empresa, contagem, files[].
Obter Dados
GET https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
Cabeçalhos:
- Authorization: Bearer YOUR_API_KEY
- If-Modified-Since: {Last-Modified de um anterior 200} (opcional, para cache)
Retorna empresa, arquivo, updated_at (UTC) e dados (JSON bruto da casa de apostas). Envia cabeçalho Last-Modified; 304 quando inalterado se você fornecer If-Modified-Since.
FAQ
P: Como sei quais nomes de arquivos posso buscar?
A: Chame o endpoint Listar Arquivos. Solicite apenas os nomes encontrados no array de arquivos.
P: Qual é o fuso horário de updated_at?
A: UTC (por exemplo, 2026-09-27T18:24:34Z). Use-o para auditoria e verificações de obsolescência.
P: Posso evitar rebaixar o arquivo se nada mudou?
A: Sim. Leia o cabeçalho Last-Modified de uma resposta 200 e envie-o de volta via If-Modified-Since. Você receberá HTTP 304 quando o arquivo estiver inalterado.
P: Existem parâmetros de consulta para filtrar a lista de arquivos ou os dados?
A: Nenhum parâmetro está documentado para esses endpoints. Trate a lista como completa e os dados como o JSON completo e não modificado.
P: Como é tratado o faturamento?
A: O Zyla usa assinatura + cota (não pago por chamada). A primeira API pode oferecer um teste de 7 dias ou 50 requisições. Verifique a página da API para opções de acesso e preços atuais.
Pronto para implementar seu fluxo de trabalho de "listar e depois buscar" arquivos? Comece com a listagem oficial e obtenha sua chave: Iniciar teste de 7 dias na API de Odds da Fonbet. Uma conta e uma chave de API desbloqueiam o acesso a mais de 10.000 APIs públicas no Zyla.