API-sleutels
Maak API-sleutels om externe systemen te integreren, bouw aangepaste dashboards of automatiseer workflows met Balla Stats-gegevens.
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).
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
- Navigeer naar API-sleutels
- Maak uw eerste sleutel
- Kopieer en bewaar veilig
- Gebruik uw API-sleutel
- Gebruik controleren
- Sleutels roteren of intrekken
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.

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.

Begin met de -alleen-lezen-scope en voeg alleen schrijfrechten toe als dat nodig is. Dit volgt het principe van de minste privileges.
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.

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.
Neem uw API-sleutel op in de Authorization-header van uw HTTP-verzoeken:
curl -H "Authorization: Bearer balla_sk_..." \
https://api.ballastats.com/api/matchesOf 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.
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.

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.
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.
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
writetoe 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