Clés API

Les clés API sont générées dans le tableau de bord Mentova sous Paramètres → API. Les clés sont préfixées par mtv_live_ suivi de 32 caractères hexadécimaux.

Chaque clé n'est affichée qu'une seule fois, à sa création. Conservez-la en lieu sûr - en cas de perte, supprimez la clé et générez-en une nouvelle.

Envoyer la clé

Incluez la clé dans chaque requête via l'un de ces en-têtes :

# Recommandé
X-API-Key: mtv_live_votre_cle_ici

# Alternative
Authorization: Bearer mtv_live_votre_cle_ici

Les deux en-têtes sont acceptés. Si les deux sont présents, X-API-Key est prioritaire.

Exemple de requête

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

Condition de plan

Les clés API ne sont valides que pour les comptes Agency. Toute clé appartenant à un compte de niveau inférieur renvoie :

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

Code HTTP : 403.

Limitation de débit

Chaque clé est limitée à 60 requêtes par minute. En cas de dépassement, l'API renvoie HTTP 429 avec un en-tête Retry-After: 60. Le limiteur de débit est permissif en cas de panne - si Redis est indisponible, toutes les requêtes sont autorisées.

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

Réponses d'erreur