API-sleutels

Maak API-sleutels om externe systemen te integreren, bouw aangepaste dashboards of automatiseer workflows met Balla Stats-gegevens.

Gemiddeld
12 minuten

Vereisten

Voordat u API-sleutels maakt, heeft u het volgende nodig:

  • Een Balla Stats-account
  • PRO-abonnement of hoger

Planlimieten: GRATIS = 0 sleutels, PRO = 3 sleutels (1.000 aanvraag/uur), TEAM = 10 sleutels (10.000 aanvraag/uur), ENTERPRISE = 50 sleutels (100.000 aanvraag/uur).

Programmatische API-toegang

Maak API-sleutels om externe systemen te integreren, bouw aangepaste dashboards of automatiseer workflows met Balla Stats-gegevens.

Bereikte machtigingen

Gedetailleerde toegangscontrole

Snelheidslimiet

Limieten voor aanvragen per sleutel

Gebruik bijhouden

Volledig audittraject

Wat je gaat leren
  • Navigeer naar API-sleutels
  • Maak uw eerste sleutel
  • Kopieer en bewaar veilig
  • Gebruik uw API-sleutel
  • Gebruik controleren
  • Sleutels roteren of intrekken
1
Navigeer naar API-sleutels

Klik in de zijbalk van het dashboard op API Keys. Op deze pagina worden al uw bestaande sleutels weergegeven en kunt u nieuwe sleutels maken.

Beheerpagina API-sleutels
2
Maak uw eerste sleutel

Klik op "API-sleutel maken" , voer een beschrijvende naam in en selecteer de bereiken die uw sleutel nodig heeft. Beschikbare bereiken zijn onder meer: ​​ read, write, matches, players, teams, seasons, and stats.

Maak een API-sleuteldialoogvenster met bereikselectie

Begin met de -alleen-lezen-scope en voeg alleen schrijfrechten toe als dat nodig is. Dit volgt het principe van de minste privileges.

3
Kopieer en bewaar uw sleutel

Uw sleutel wordt weergegeven in het formaat balla_sk_[64 hexadecimale tekens]. Dit is de enige keer dat u de volledige sleutel ziet. Kopieer het onmiddellijk en bewaar het op een veilige locatie.

API-sleutelgeheim één keer weergegeven - kopieer het nu

Uw API-sleutel wordt slechts één keer getoond. Kopieer hem nu en bewaar hem veilig. Het kan later niet meer worden opgehaald. Als u deze kwijtraakt, moet u de sleutel roteren of een nieuwe maken.

4
Gebruik uw API-sleutel

Neem uw API-sleutel op in de Authorization-header van uw HTTP-verzoeken:

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

Of in 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();

Alle eindpunten zijn gedocumenteerd op /api-docs. Zie de API-documentatie-tutorial voor meer informatie.

5
Gebruik controleren

Bekijk de laatst gebruikte tijdstempel van uw sleutel, het totale aantal verzoeken en de huidige tarieflimietstatus. Gebruiksstatistieken geven u inzicht in hoe uw integraties presteren en wanneer u uw abonnement mogelijk moet upgraden.

Statistieken over het gebruik van API-sleutels
6
Toetsen roteren of intrekken

Roteer een sleutel om een ​​nieuwe te maken met behoud van de naam, het bereik en de instellingen. De oude sleutel wordt onmiddellijk ingetrokken. Intrekken deactiveert een sleutel permanent. Ingetrokken sleutels kunnen niet opnieuw worden geactiveerd.

Door een sleutel om te draaien, wordt de oude sleutel onmiddellijk ongeldig. Update uw integraties met de nieuwe sleutel voordat u deze rouleert, om downtime te voorkomen.

Tips

Gebruik beschrijvende namen

Gebruik beschrijvende namen zoals 'Dashboard Bot' of 'Stats Exporter', zodat u gemakkelijk het doel van elke sleutel kunt identificeren.

Minste privilege

Volg het principe van de minste privileges: geef alleen de scopes die uw integratie daadwerkelijk nodig heeft.

Regelmatige rotatie

Roteer sleutels regelmatig (elke 90 dagen) voor de veiligheid. Stel een herinnering in om op de hoogte te blijven van de belangrijkste hygiënemaatregelen.

Stel sleutels nooit bloot

Leg API-sleutels nooit vast in de broncode en deel ze niet in platte tekst. Gebruik omgevingsvariabelen of geheime managers.

Veelvoorkomende problemen

401 Ongeautoriseerd

  • Uw sleutel is mogelijk inactief, ingetrokken of verlopen
  • Controleer of de sleutel is opgenomen in de autorisatiekop
  • Zorg ervoor dat het headerformaat Bearer balla_sk_...

403 Verboden

  • Uw sleutel heeft niet het vereiste bereik voor dit eindpunt
  • Bewerk de sleutel om het benodigde bereik toe te voegen (voeg bijvoorbeeld write toe voor POST-verzoeken)
  • Controleer de API-documenten waarvoor elk eindpunt

vereist 429 Te veel verzoeken

  • U heeft uw tarieflimiet voor het huidige uur
  • overschreden Wacht tot het tarieflimietvenster opnieuw is ingesteld of upgrade uw abonnement voor hogere limieten
  • Controleer de Retry-After-header voor wanneer u het opnieuw kunt proberen