API-sleutels

API-sleutels worden gegenereerd in het Mentova-dashboard onder Instellingen → API. Sleutels beginnen met het voorvoegsel mtv_live_, gevolgd door 32 hexadecimale tekens.

Elke sleutel wordt maar één keer getoond, bij het aanmaken ervan. Bewaar hem op een veilige plaats - als u hem kwijtraakt, verwijdert u de sleutel en genereert u een nieuwe.

De sleutel verzenden

Voeg de sleutel toe aan elke aanvraag via een van deze headers:

# Recommandé
X-API-Key: mtv_live_votre_cle_ici

# Alternative
Authorization: Bearer mtv_live_votre_cle_ici

Beide headers worden geaccepteerd. Als beide aanwezig zijn, heeft X-API-Key voorrang.

Voorbeeldaanvraag

curl https://mentova.ai/api/v1/brands \
  -H "X-API-Key: mtv_live_votre_cle_ici"

Planvereiste

API-sleutels zijn alleen geldig voor Agency-accounts. Een sleutel van een account met een lager abonnement levert het volgende op:

{
  "error": "API access requires Agency plan",
  "code": "PLAN_REQUIRED"
}

HTTP-status: 403.

Snelheidslimiet

Elke sleutel is beperkt tot 60 aanvragen per minuut. Bij overschrijding retourneert de API HTTP 429 met een header Retry-After: 60. De snelheidslimiter is permissief bij een storing - als Redis niet beschikbaar is, worden alle aanvragen toegestaan.

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMITED"
}

Foutresponsen