Necesitas una API para listar los archivos que puedes leer, verificar que un archivo objetivo existe y luego obtenerlo sin adivinar nombres o rutas. Al final de este artículo, llamarás a un verdadero endpoint de "listar archivos", analizarás su respuesta y obtendrás uno de los archivos que devuelve—de manera limpia, con semánticas de caché que puedes integrar en producción esta semana.
Qué hace esta API
La API de Cuotas de Fonbet en Zyla API Hub expone acceso orientado a archivos a instantáneas de cuotas de casas de apuestas. Ofrece:
- Un endpoint de listado de archivos que devuelve el conjunto exacto de archivos de cuotas que tu suscripción puede leer, ordenados por nombre. Llama a esto primero y trabaja solo con los nombres que proporciona.
- Un endpoint para obtener uno de esos archivos, devuelto en un sobre con metadatos y el JSON original de la casa de apuestas sin cambios.
Este es un flujo de trabajo de gestión de archivos: descubre los archivos disponibles, selecciona uno por nombre y descárgalo. Es adecuado para agilizar trabajos de ingestión, verificar el acceso antes de programar descargas y mantener tu canal de cuotas resistente.
Comenzando en Zyla API Hub
Abre la página de la API para la API de Cuotas de Fonbet, haz clic en Suscribirse o Comenzar Prueba Gratuita si está disponible, y obtén tu clave API. La autenticación es un solo encabezado que agregas a las solicitudes. Zyla API Hub utiliza un modelo de suscripción + cuota (no pago por llamada). La primera API en tu cuenta puede ofrecer una prueba de 7 días o 50 solicitudes; siempre verifica la página de la API para las opciones de acceso y precios actuales.
Puedes explorar miles de APIs listas para producción en Zyla API Hub, todas bajo una cuenta y una clave API. Cuando estés listo para probar esta API específica, usa el enlace de listado a continuación.
Los endpoints que usarás
Base: Todas las llamadas van a las URL de Zyla Hub que se muestran a continuación. No agregues parámetros de consulta a menos que estén documentados. Se requiere autenticación a través de Authorization: Bearer YOUR_API_KEY.
1) Listar Archivos
- Método: GET
- URL: https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
- Descripción: Lista los archivos de cuotas que tu suscripción puede leer, ordenados por nombre. Devuelve empresa, conteo y archivos (un arreglo de nombres de archivos). Llama a esto primero y solicita solo los nombres que devuelve.
- Parámetros: Ninguno documentado.
cURL (copiable):
curl -s -X GET "https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files" \
-H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta oficial:
{
"company": "fonbet",
"count": 1,
"files": [
"site_livepre_fonbet.json"
]
}
Lo que realmente usarás:
- company: Cadena que identifica al proveedor de datos (aquí, "fonbet").
- count: Número de archivos a los que tu suscripción actual puede acceder.
- files: Arreglo de nombres de archivos. Estos son los únicos inputs válidos que deberías intentar obtener.
2) Obtener Datos
- Método: GET
- URL: https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
- Descripción: Devuelve un archivo de cuotas dentro de un sobre: {"company", "file", "updated_at", "data"}. El campo de datos contiene el JSON original de la casa de apuestas, sin cambios. updated_at es la última hora de actualización (UTC). La misma hora se proporciona a través del encabezado Last-Modified; envíalo de vuelta a través de If-Modified-Since para recibir un 304 cuando nada haya cambiado.
- Parámetros: Ninguno documentado.
cURL:
Ejemplo de respuesta (sobre con JSON de cuotas en bruto en datos):
Puntos clave para uso en producción:
- updated_at es UTC. Trátalo como tu reloj canónico para verificaciones de obsolescencia.
- Usa encabezados de caché HTTP: en cada GET exitoso, lee Last-Modified; envíalo de vuelta como If-Modified-Since en solicitudes posteriores para evitar descargas innecesarias cuando los datos no hayan cambiado.
- El JSON de la casa de apuestas bajo datos no está modificado; la estructura puede ser grande y anidada, así que analiza solo lo que necesitas.
Ejemplo de extremo a extremo: descubrir y obtener un archivo
Esquema del flujo de trabajo:
- Llama a Listar Archivos para descubrir los nombres de archivos permitidos.
- Selecciona el archivo que necesitas de files[].
- Llama a Obtener Datos para recuperar el sobre con el JSON de cuotas en bruto.
- Almacena updated_at y el encabezado Last-Modified para futuras solicitudes condicionales.
Ejemplo en Python
Este script lista archivos, selecciona el primer nombre de archivo, lo obtiene e imprime metadatos básicos. También demuestra cómo leer Last-Modified para configurar solicitudes condicionales más adelante.
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"Conteo de archivos: {listing.get('count')}")
files = listing.get("files", [])
if not files:
print("No hay archivos disponibles para esta suscripción.")
sys.exit(0)
target = files[0]
print(f"Obteniendo: {target} a través del endpoint Obtener Datos")
# Primera obtención
result = get_data()
print(f"HTTP: {result['status']}, Last-Modified: {result['last_modified']}")
if result["body"]:
env = result["body"]
print(f"Sobre: empresa={env.get('company')}, archivo={env.get('file')}, updated_at={env.get('updated_at')}")
# El JSON en bruto de la casa de apuestas está en env['data']; evita imprimir cargas grandes en producción.
# Ejemplo de solicitud condicional usando Last-Modified
if result["last_modified"]:
result2 = get_data(if_modified_since=result["last_modified"])
print(f"Obtención condicional -> HTTP: {result2['status']} (304 significa sin cambios)")
if __name__ == "__main__":
main()
Notas:
- El endpoint Listar Archivos no documenta parámetros de solicitud—no agregues ninguno.
- El endpoint Obtener Datos tampoco documenta parámetros; devolverá el archivo permitido dentro de su sobre estándar.
- Usa timeouts que tengan sentido para tu entorno y registra Last-Modified para ejecuciones incrementales.
Detalles de integración práctica que ahorran tiempo
- Autenticación: Siempre envía Authorization: Bearer YOUR_API_KEY.
- Nombres de archivos: Trata files[] de Listar Archivos como la fuente de verdad. No codifiques nombres fuera de lo que devuelve la API.
- Orden: La lista está ordenada por nombre. Si esperas solo uno, afirma count == 1 para fallar rápido cuando tu suscripción cambie.
- Marcas de tiempo: updated_at es una cadena ISO 8601 UTC (por ejemplo, 2026-09-27T18:24:34Z). Almacénala junto a tu lote de ingestión para auditoría.
- Caché: Respeta Last-Modified/If-Modified-Since para minimizar el ancho de banda y el procesamiento. Un 304 significa que puedes reutilizar tu última instantánea.
- Paginación: No documentada en Listar Archivos; codifica como si la lista encajara en una página. Si tu suscripción crece, revisa nuevamente la documentación en la página de la API.
- Volumen de datos: data es el JSON original de la casa de apuestas. Puede ser considerable; transmite a disco o analiza selectivamente.
- Manejo de errores: Maneja 401/403 para problemas de autenticación/suscripción y 304 para aciertos de caché. Las respuestas no 200 deben ser reintentadas conscientemente.
- Entorno: Mantén la clave API fuera del control de versiones. Parametriza los timeouts y el retroceso.
- Despliegue: Ejecuta Listar Archivos al inicio o según un horario para detectar cambios en archivos accesibles antes de obtener.
Casos de uso en el mundo real
- Bootstrap ETL: Usa Listar Archivos para validar el acceso al inicio de un trabajo, obtiene el único archivo en vivo, agrega updated_at y Last-Modified a los metadatos de tu trabajo y empuja las cuotas analizadas a tu almacén.
- Sincronizaciones incrementales: En un temporizador, llama a Obtener Datos con If-Modified-Since. Si 304, omite; si 200, procesa diferencias mínimas basadas en updated_at.
- Monitoreo de acceso: Alerta cuando el conteo o los nombres de archivos de Listar Archivos cambien (por ejemplo, se agregó/se eliminó un archivo para tu plan).
- Calentamiento de caché: Pre-obtén durante el despliegue usando Listar Archivos para elegir objetivos, luego Obtener Datos para calentar cachés antes del tráfico de usuarios.
Llamando desde agentes de IA a través de MCP
Cada API en Zyla puede ser llamada por agentes de IA a través del endpoint MCP. Apunta tu cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf) al gateway MCP y pasa tu clave API de Zyla. Tu agente puede entonces invocar las mismas URL de Hub que se muestran arriba usando el mismo encabezado de Autorización.
Documentación y endpoint: MCP
Flujo típico dentro de un agente:
- Paso de herramienta 1: GET la URL de Listar Archivos con tu encabezado de Autorización; analiza files[].
- Paso de herramienta 2: GET la URL de Obtener Datos; si Last-Modified está presente, almacena en caché y reutiliza a través de If-Modified-Since.
Si tu equipo gestiona múltiples APIs a través de Zyla, MCP centraliza el acceso bajo una clave y una capa de integración. Puedes explorar más opciones en Zyla API Hub.
Referencias listas para copiar
Listar Archivos
GET https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
Encabezados:
- Authorization: Bearer YOUR_API_KEY
Devuelve empresa, conteo, files[].
Obtener Datos
GET https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
Encabezados:
- Authorization: Bearer YOUR_API_KEY
- If-Modified-Since: {Last-Modified de un anterior 200} (opcional, para caché)
Devuelve empresa, archivo, updated_at (UTC) y datos (JSON en bruto de la casa de apuestas). Envía el encabezado Last-Modified; 304 cuando no hay cambios si proporcionas If-Modified-Since.
FAQ
Q: ¿Cómo sé qué nombres de archivos puedo obtener?
A: Llama al endpoint Listar Archivos. Solo solicita nombres que se encuentren en el arreglo de archivos.
Q: ¿Qué zona horaria tiene updated_at?
A: UTC (por ejemplo, 2026-09-27T18:24:34Z). Úsalo para auditoría y verificaciones de obsolescencia.
Q: ¿Puedo evitar volver a descargar el archivo si nada ha cambiado?
A: Sí. Lee el encabezado Last-Modified de una respuesta 200 y envíalo de vuelta a través de If-Modified-Since. Recibirás HTTP 304 cuando el archivo no haya cambiado.
Q: ¿Hay parámetros de consulta para filtrar la lista de archivos o los datos?
A: No se documentan parámetros para estos endpoints. Trata la lista como completa y los datos como el JSON completo y sin modificar.
Q: ¿Cómo se maneja la facturación?
A: Zyla utiliza suscripción + cuota (no pago por llamada). La primera API puede ofrecer una prueba de 7 días o 50 solicitudes. Verifica la página de la API para las opciones de acceso y precios actuales.
¿Listo para implementar tu flujo de trabajo de "listar y luego obtener" archivos? Comienza con el listado oficial y obtén tu clave: Comienza prueba de 7 días en la API de Cuotas de Fonbet. Una cuenta y una clave API desbloquean el acceso a más de 10,000 APIs públicas en Zyla.