Clés secrètes

Une clé secrète (sk_…) authentifie ton backend auprès de l’API serveur d’un projet : persons et suppression RGPD. Elles se gèrent dans Réglages › Clés secrètes.

Créer une clé

Donne-lui un nom qui dit qui l’utilise (« Backend production », « Script de synchro CRM »), puis Créer la clé.

Copie-la aussitôt : elle n’est affichée qu’une seule fois. Belvdr n’en garde qu’une empreinte et ne peut pas la réafficher. Si tu la perds, crée-en une autre et révoque l’ancienne.

L’utiliser

Envoie-la dans l’en-tête Authorization de chaque appel :

curl https://api.belvdr.com/v1/persons \
  -H "Authorization: Bearer sk_…"

• Côté serveur uniquement : jamais dans le code d’une page, d’une application mobile ou d’un dépôt de code. Garde-la dans les secrets de ton hébergeur ou une variable d’environnement.
• La liste des clés indique la date de dernière utilisation de chacune.

Refus	Cause
401 missing_secret_key	Pas d’en-tête Authorization: Bearer …
401 invalid_secret_key	Clé inconnue
401 revoked_secret_key	Clé révoquée
403 public_key_not_allowed	Clé publique (pk_…) à la place d’une clé secrète

Une clé par usage

Crée une clé par service ou par environnement qui appelle l’API. Tu pourras en révoquer une sans couper les autres.

Révoquer une clé

Révoquer, en face de la clé, puis confirmer. Les appels avec cette clé sont refusés immédiatement (401 revoked_secret_key). La révocation est définitive.