Générer et gérer des clés API

Les clés API permettent à tes propres systèmes de se connecter à VerifyPDF. Tu les gères dans le tableau de bord, sous Développeurs. Cet article te montre comment créer une clé et garder tes clés bien rangées.

Crée une clé API

1. Connecte-toi sur secure.verifypdf.com.
2. Ouvre Développeurs dans la barre latérale de gauche. Elle y est toujours visible.
3. Sélectionne Créer une clé et donne-lui un nom clair, par exemple Billing system ou Test integration.
4. La clé complète s’affiche une seule fois, juste après sa création. Copie-la maintenant et range-la en lieu sûr.

Après avoir fermé cet écran, VerifyPDF n’affiche plus qu’une version masquée de la clé (les derniers caractères) ainsi qu’une heure de dernière utilisation. Il n’y a aucun moyen de révéler à nouveau la valeur complète.

Tu peux avoir jusqu’à 10 clés à la fois. Si tu atteins la limite, supprime une clé que tu n’utilises plus pour libérer un emplacement.

Les clés sont partagées dans ton organisation

Les clés API sont à l’échelle de l’organisation, pas personnelles. Tout coéquipier ayant accès au tableau de bord peut voir les clés masquées et les gérer. Traite une clé comme un mot de passe partagé. Pour savoir qui a accès, voir Rôles administrateur et membre.

Renomme, fais tourner ou supprime une clé

Depuis la section Développeurs, tu peux :

• Renommer une clé pour que son objectif reste évident à mesure que ton équipe grandit.
• Faire tourner une clé quand elle a pu fuiter ou quand tu veux une nouvelle valeur. La rotation te donne une nouvelle clé à copier une fois, puis tu mets à jour ton intégration.
• Supprimer une clé que tu n’utilises plus. Tout système qui utilise encore une clé supprimée cessera de fonctionner, retire-la donc d’abord de ton intégration.

Garde tes clés en sécurité

• Copie la clé complète au moment où elle s’affiche. Tu ne la reverras pas.
• Ne colle jamais une clé dans du code public, un chat ou des captures d’écran.
• Fais tourner une clé tout de suite si tu penses qu’elle a été exposée.

Et après

• Tu commences à développer ? Voir Clés API de test et live.
• Prêt à appeler l’API ? Voir Vérifier un document avec l’API.