Authenticatie

De Macaly API gebruikt API-sleutels voor authenticatie. API-sleutels zijn gekoppeld aan het team en delen hetzelfde creditsysteem als de webinterface.

Een API-sleutel ophalen

Log in op uw Macaly-account
Klik op uw profiel (rechtsboven)
Ga naar Instellingen → API-sleutels
Klik op “Nieuwe API-sleutel aanmaken”
Kopieer de sleutel onmiddellijk (deze wordt slechts één keer getoond)

De API-sleutel gebruiken

Voeg de API-sleutel toe aan de Authorization-header voor alle verzoeken:

Authorization: Bearer macaly_your_api_key_here

Voorbeeldverzoek

curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Create a landing page"}'

API-sleutelformaat

Eigenschap	Waarde
Prefix	`macaly_`
Totale lengte	39 tekens
Voorbeeld	`macaly_abc123def456ghi789jkl012mno345`

Best practices voor beveiliging

API-sleutels geven volledige toegang tot de resources en credits van uw team. Behandel ze als wachtwoorden.

Sla sleutels veilig op - Gebruik omgevingsvariabelen, commit ze nooit in de code
Vernieuw sleutels regelmatig - Trek sleutels periodiek in en maak nieuwe aan
Gebruik aparte sleutels - Maak verschillende sleutels voor verschillende omgevingen en applicaties
Houd het gebruik in de gaten - Controleer uw saldo regelmatig via het dashboard
Trek gecompromitteerde sleutels in - Als een sleutel is blootgesteld, trek deze dan onmiddellijk in

Limieten

Mislukte API-sleutelpogingen zijn gelimiteerd tot 5 per minuut per IP
Dit beschermt tegen brute-force-aanvallen

Sleutelbeheer

U kunt uw API-sleutels beheren in het Macaly-dashboard:

Sleutels bekijken - Bekijk alle actieve sleutels met hun aanmaakdatum en laatste gebruik
Sleutels aanmaken - Genereer nieuwe sleutels met optionele namen ter identificatie
Sleutels intrekken - Schakel sleutels uit die niet meer nodig zijn of gecompromitteerd zijn