Clés API & sécurité

Format des clés

sk_live_abc123def456...

• Préfixe sk_live_ (production) ou sk_test_ (sandbox, à venir).
• 64 caractères alphanumériques.
• Affichée une seule fois au moment de la création. Stocke-la en lieu sûr (1Password, Vault).

Générer une clé

1. Paramètres → API & intégrations.
2. Cliquez + Nouvelle clé API.
3. Donne-lui un nom (ex: "Zapier prod", "Script Python interne").
4. (Optionnel) Restreins par scopes (MAX uniquement) :

- prospects:read / prospects:write

- campaigns:read / campaigns:write

- deals:read / deals:write

- * (full access)

1. Copie la clé immédiatement après affichage.

Révoquer une clé

1. Paramètres → API & intégrations.
2. Liste des clés → bouton Révoquer.
3. Confirmation → la clé est invalidée immédiatement (toutes les requêtes futures retournent 401).

À faire systématiquement :

• Si vous suspectez une fuite.
• Si vous changez de prestataire (script externe).
• Si un membre de l'équipe quitte.

Bonnes pratiques

• ❌ Jamais de clé en clair dans un repo Git.
• ❌ Jamais de clé dans le code frontend (visible aux users).
• ✅ Stocke en variables d'environnement (.env, Vercel env, AWS Secrets Manager).
• ✅ Rotate vos clés tous les 6-12 mois.
• ✅ Scope au strict minimum (1 clé Zapier = lecture prospects + écriture deals, pas full access).

Limites par plan

Audit log

Sur MAX, Paramètres → API → Audit log :

• Historique des 30 derniers jours.
• Filtrable par clé, endpoint, status code, IP.
• Export CSV.

FAQ rapide

Une clé compromise = data leak ? Oui, révoque immédiatement et change ce qui a pu être consulté.

Restriction par IP ? Pas encore, et pas de date annoncée.

Sandbox / test mode ? Pas encore, et pas de date annoncée.

Articles liés

• API publique v1
• Webhooks sortants
• Inviter mon équipe