Balla StatsTous les tutoriels

Cles API

Creez des cles API pour integrer des systemes externes, construire des tableaux de bord personnalises ou automatiser des flux de travail avec les donnees de Balla Stats.

Intermediaire
12 minutes

Prerequis

Avant de creer des cles API, vous avez besoin de :

  • Un compte Balla Stats
  • Plan PRO ou superieur

Limites du plan : FREE = 0 cles, PRO = 3 cles (1 000 req/h), TEAM = 10 cles (10 000 req/h), ENTERPRISE = 50 cles (100 000 req/h).

Acces programmatique a l'API

Creez des cles API pour integrer des systemes externes, construire des tableaux de bord personnalises ou automatiser des flux de travail avec les donnees de Balla Stats.

Permissions avec portee

Controle d'acces granulaire

Limitation de debit

Limites de requetes par cle

Suivi d'utilisation

Piste d'audit complete

Ce que vous apprendrez
  • Naviguer vers les cles API
  • Creer votre premiere cle
  • Copier et sauvegarder en securite
  • Utiliser votre cle API
  • Surveiller l'utilisation
  • Effectuer une rotation ou revoquer les cles
1
Naviguer vers les cles API

Dans la barre laterale du tableau de bord, cliquez sur Cles API. Cette page affiche toutes vos cles existantes et vous permet d'en creer de nouvelles.

Page de gestion des cles API
2
Creez votre premiere cle

Cliquez sur "Creer une cle API", entrez un nom descriptif et selectionnez les portees dont votre cle a besoin. Les portees disponibles incluent : read, write, matches, players, teams, seasons, and stats.

Boite de dialogue de creation de cle API avec selection de portees

Commencez avec la portee lecture seule et ajoutez les permissions d'ecriture uniquement lorsque necessaire. Cela suit le principe du moindre privilege.

3
Copiez et sauvegardez votre cle

Votre cle sera affichee dans le format balla_sk_[64 caracteres hexadecimaux]. C'est la seule fois que vous verrez la cle complete. Copiez-la immediatement et stockez-la dans un endroit securise.

Secret de cle API affiche une seule fois - copiez-le maintenant

Votre cle API ne sera affichee qu'une seule fois. Copiez-la maintenant et stockez-la en securite. Elle ne peut pas etre recuperee plus tard. Si vous la perdez, vous devrez effectuer une rotation ou creer une nouvelle cle.

4
Utilisez votre cle API

Incluez votre cle API dans l'en-tete Authorization de vos requetes HTTP :

curl -H "Authorization: Bearer balla_sk_..." \
  https://api.ballastats.com/api/matches

Ou 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();

Tous les endpoints sont documentes a /api-docs. Consultez le tutoriel Documentation API pour plus de details.

5
Surveiller l'utilisation

Consultez l'horodatage de derniere utilisation de votre cle, le nombre total de requetes et l'etat actuel de la limite de debit. Les statistiques d'utilisation vous aident a comprendre les performances de vos integrations et quand vous pourriez avoir besoin de mettre a jour votre plan.

Statistiques d'utilisation de la cle API
6
Effectuer une rotation ou revoquer les cles

La rotation d'une cle en cree une nouvelle tout en preservant son nom, ses portees et ses parametres. L'ancienne cle est immediatement revoquee. Revoquer desactive definitivement une cle. Les cles revoquees ne peuvent pas etre reactivees.

La rotation d'une cle invalide immediatement l'ancienne cle. Mettez a jour vos integrations avec la nouvelle cle avant la rotation pour eviter les interruptions.

Conseils

Utilisez des noms descriptifs

Utilisez des noms descriptifs comme "Bot du tableau de bord" ou "Exportateur de stats" pour identifier facilement l'objectif de chaque cle.

Moindre privilege

Suivez le principe du moindre privilege - n'accordez que les portees dont votre integration a reellement besoin.

Rotation reguliere

Effectuez une rotation des cles regulierement (tous les 90 jours) pour la securite. Mettez un rappel pour maintenir l'hygiene des cles.

N'exposez jamais les cles

Ne commitez jamais les cles API dans le code source et ne les partagez jamais en texte clair. Utilisez des variables d'environnement ou des gestionnaires de secrets.

Problemes courants

401 Non autorise

  • Votre cle peut etre inactive, revoquee ou expiree
  • Verifiez que la cle est incluse dans l'en-tete Authorization
  • Assurez-vous que le format de l'en-tete est Bearer balla_sk_...

403 Interdit

  • Votre cle n'a pas la portee requise pour ce endpoint
  • Modifiez la cle pour ajouter la portee necessaire (par exemple, ajoutez write pour les requetes POST)
  • Consultez la documentation API pour savoir quelles portees chaque endpoint requiert

429 Trop de requetes

  • Vous avez depasse votre limite de debit pour l'heure en cours
  • Attendez que la fenetre de limite se reinitialise, ou mettez a niveau votre plan pour des limites plus elevees
  • Verifiez l'en-tete Retry-After pour savoir quand vous pouvez reessayer

Cet article vous a-t-il ete utile?