Marvin · Developers

Authentification

Clés d'API, scopes et sécurité

L'API utilise une clé d'API (une par client Marvin), transmise dans chaque requête via le header :

X-Marvin-Public-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Obtenir une clé

La clé est générée par l'administrateur du client Marvin, depuis Configuration → Intégrations, puis transmise à l'intégrateur.

  • La clé pk_live_… ne s'affiche qu'une seule fois à la création — elle doit être copiée immédiatement.
  • Un administrateur peut générer et révoquer autant de clés que nécessaire.

Portée (scopes)

Une clé est strictement limitée : elle ne donne accès qu'aux endpoints couverts par ses scopes, et uniquement pour l'environnement du client qui l'a émise. Elle ne permet d'accéder à aucune autre donnée ni au reste de l'API.

ScopeAutorise
partner:projects:readGET /v1/partner/projects
partner:candidates:writePOST /v1/partner/candidates

Erreurs d'authentification

StatutCas
401Clé absente, malformée, inconnue ou révoquée
403Scope requis manquant
429Débit dépassé (limité par clé)

Ne committez jamais une clé pk_live_… dans un dépôt public et ne l'exposez pas côté navigateur. Une clé doit rester côté serveur.

On this page