Claves API
Crea claves API para integrar sistemas externos, construir paneles personalizados o automatizar flujos de trabajo con datos de Balla Stats.
Requisitos previos
Antes de crear claves API, necesitas:
- Una cuenta de Balla Stats
- Plan PRO o superior
Limites del plan: FREE = 0 claves, PRO = 3 claves (1,000 req/hr), TEAM = 10 claves (10,000 req/hr), ENTERPRISE = 50 claves (100,000 req/hr).
Crea claves API para integrar sistemas externos, construir paneles personalizados o automatizar flujos de trabajo con datos de Balla Stats.
Permisos con alcance
Control de acceso granular
Limite de solicitudes
Limites de solicitudes por clave
Seguimiento de uso
Registro de auditoria completo
- Navegar a Claves API
- Crear tu primera clave
- Copiar y guardar de forma segura
- Usar tu clave API
- Monitorear el uso
- Rotar o revocar claves
En la barra lateral del panel, haz clic en Claves API. Esta pagina muestra todas tus claves existentes y te permite crear nuevas.
Haz clic en "Crear Clave API", ingresa un nombre descriptivo y selecciona los alcances que tu clave necesita. Los alcances disponibles incluyen: read, write, matches, players, teams, seasons, and stats.
Comienza con alcance de solo lectura y agrega permisos de escritura solo cuando sea necesario. Esto sigue el principio de minimo privilegio.
Tu clave se mostrara en el formato balla_sk_[64 caracteres hexadecimales]. Esta es la unica vez que veras la clave completa. Copiala inmediatamente y guardala en un lugar seguro.
Tu clave API solo se mostrara una vez. Copiala ahora y guardala de forma segura. No se puede recuperar despues. Si la pierdes, necesitaras rotar o crear una nueva clave.
Incluye tu clave API en el encabezado Authorization de tus solicitudes HTTP:
curl -H "Authorization: Bearer balla_sk_..." \
https://api.ballastats.com/api/matchesO en JavaScript:
const response = await fetch(
'https://api.ballastats.com/api/matches',
{
headers: {
'Authorization': 'Bearer balla_sk_...',
'Content-Type': 'application/json',
},
}
);
const data = await response.json();Todos los endpoints estan documentados en /api-docs. Consulta el tutorial de Documentacion API para mas detalles.
Ve la ultima marca de tiempo de uso de tu clave, el conteo total de solicitudes y el estado actual del limite de solicitudes. Las estadisticas de uso te ayudan a entender como funcionan tus integraciones y cuando podrias necesitar actualizar tu plan.
Rotar una clave crea una nueva mientras preserva su nombre, alcances y configuracion. La clave anterior se revoca inmediatamente. Revocar desactiva permanentemente una clave. Las claves revocadas no pueden reactivarse.
Rotar una clave invalida la clave anterior inmediatamente. Actualiza tus integraciones con la nueva clave antes de rotar para evitar interrupciones.
Usa nombres descriptivos
Usa nombres descriptivos como "Bot del Panel" o "Exportador de Estadisticas" para identificar facilmente el proposito de cada clave.
Minimo privilegio
Sigue el principio de minimo privilegio - otorga solo los alcances que tu integracion realmente necesita.
Rotacion regular
Rota las claves regularmente (cada 90 dias) por seguridad. Pon un recordatorio para mantener la higiene de claves.
Nunca expongas las claves
Nunca subas claves API al codigo fuente ni las compartas en texto plano. Usa variables de entorno o gestores de secretos.
401 No autorizado
- Tu clave puede estar inactiva, revocada o expirada
- Verifica que la clave este incluida en el encabezado Authorization
- Asegurate de que el formato del encabezado sea
Bearer balla_sk_...
403 Prohibido
- Tu clave no tiene el alcance requerido para este endpoint
- Edita la clave para agregar el alcance necesario (por ejemplo, agrega
writepara solicitudes POST) - Consulta la documentacion API para saber que alcances requiere cada endpoint
429 Demasiadas solicitudes
- Has excedido tu limite de solicitudes para la hora actual
- Espera a que se reinicie la ventana de limite, o actualiza tu plan para limites mas altos
- Revisa el encabezado
Retry-Afterpara saber cuando puedes reintentar
Te resulto util este articulo?