Aller au contenu

Créer et gérer vos clés API

Créez une clé API pour un outil ou un script, choisissez une clé de production ou de test et ses contrôles, puis révoquez-la dès que l'outil n'en a plus besoin.

Une clé API permet à un outil de vérifier des adresses sur votre compte sans votre mot de passe : une plateforme d'automatisation, un formulaire d'inscription, un script ou votre propre application. Chaque clé porte ses propres contrôles et ses propres droits : donnez sa clé à chaque outil, et vous pourrez en révoquer une sans toucher aux autres.

Pour connecter un assistant IA comme Claude ou ChatGPT, passez plutôt par un agent : voir Connecter un assistant IA.

Créer une clé

  1. Dans PricklyMails

    Ouvrir la page des clés

    Dans la barre latérale, sous Développeur, ouvrez Clés API et cliquez sur Nouvelle clé.

  2. Dans PricklyMails

    Nommer la clé

    Donnez-lui un nom qui dit où elle sert, par exemple le nom de l'outil, puis cliquez sur Suivant. Un nom compte au plus 64 caractères : lettres, chiffres, espaces, tirets et underscores. Laissez Expire le vide pour une clé qui n'expire jamais, ou choisissez une date jusqu'à 364 jours d'ici pour une clé qui cesse de fonctionner d'elle-même, comme une clé prêtée à un prestataire. Pour la changer ensuite, ouvrez la clé et choisissez une nouvelle date sous Expiration : une date plus lointaine réactive une clé expirée. Passé cette date, la clé est refusée comme une clé révoquée, et la liste l'affiche Expirée.

  3. Dans PricklyMails

    Choisir son environnement et ses contrôles

    Choisissez Production ou Test, comme expliqué plus bas. Sous Contrôles activés, gardez les contrôles que chaque requête doit lancer : chacun affiche son coût en jetons, et le total par email apparaît sous la liste. Sous Portées, une nouvelle clé peut vérifier une adresse, vérifier une liste et lire les résultats ; décochez ce dont l'outil n'a pas besoin. Cliquez ensuite sur Suivant.

  4. Dans PricklyMails

    Relire et créer

    La dernière étape récapitule la clé, avec son Coût total par email. Cliquez sur Terminer.

  5. Dans PricklyMails

    Copier la clé

    Sous Votre nouvelle clé API, copiez la clé et collez-la dans votre outil, ou rangez-la dans un gestionnaire de mots de passe. Cliquez sur Je l'ai sauvegardée, qui la copie une fois de plus et ferme la fenêtre.

Attention

La clé ne s'affiche qu'à ce moment-là : nous n'en gardons qu'une empreinte, si bien que personne ne pourra vous la remontrer. Si vous la perdez, révoquez-la et créez-en une autre.

Le nombre de clés que vous pouvez créer, et le nombre de requêtes qu'une clé peut envoyer par minute, dépendent de votre offre : voir les offres. La limite d'une clé s'affiche dans la colonne Limite de débit, et elle suit votre offre quand celle-ci change.

Clés de production et clés de test

Une clé de production commence par pm_live_. Elle lance de vraies vérifications et consomme des jetons.

Une clé de test commence par pm_test_. Elle ne contacte jamais de serveur de messagerie et ne consomme aucun jeton : elle répond d'après le début de l'adresse, pour que vous puissiez vérifier que votre outil traite chaque type de résultat avant de passer en production.

Ce que renvoie une clé de test, selon le début de l'adresse
L'adresse commence parVerdictRaisonRecommandation
valid ValideLa boîte existe À envoyer
invalid InvalideLa boîte n'existe pas À retirer
catchall RisquéLe domaine accepte toutes les adresses À revoir
disposable RisquéAdresse jetable À retirer
role RisquéAdresse générique À revoir
Tout autre début ValideLa boîte existe À envoyer

Un résultat de test a la même forme qu'un résultat réel : votre outil lit donc les deux de la même façon. Une fois que tout fonctionne, passez à une clé de production.

Les contrôles d'une clé

Chaque requête envoyée avec une clé lance les contrôles qu'elle active, et coûte la somme de leurs jetons. Un contrôle que vous laissez de côté n'est pas lancé, ni facturé.

  • Format de l'adresse s'exécute toujours.
  • Cocher La boîte existe coche aussi Le domaine reçoit des emails, indispensable à ce contrôle.
  • Domaine qui accepte tout (catch-all) demande les deux.
  • Un contrôle marqué Mettre à niveau demande une offre supérieure.

Le tableau de bord fixe les contrôles d'une clé à sa création. Un développeur peut aussi demander d'autres contrôles sur une seule requête, comme l'explique la documentation de la vérification.

Cliquez sur la ligne d'une clé pour ouvrir Détails de la clé : ses portées, ses contrôles activés, sa Limite de débit, le nombre de Requêtes envoyées et sa Dernière utilisation.

Révoquer une clé

Cliquez sur la ligne de la clé pour ouvrir Détails de la clé, cliquez sur Révoquer, puis sur Révoquer la clé. La clé cesse aussitôt de fonctionner, et c'est irréversible : un outil qui l'utilise encore est refusé. Elle reste dans la liste avec le statut Révoquée.

Révoquez une clé quand vous n'utilisez plus un outil, ou dès que vous pensez qu'elle a fuité. Pour remplacer une clé sans coupure, créez d'abord la nouvelle, mettez-la dans l'outil, puis révoquez l'ancienne.

Pour les développeurs

Les pages Clés API et Authentification de la documentation couvrent les requêtes : comment envoyer la clé, comment créer et révoquer des clés par l'API, et le mode test.

Questions fréquentes

Puis-je revoir une clé après avoir fermé la fenêtre ?

Non. Nous ne gardons qu'une empreinte de la clé, jamais la clé elle-même : créez-en une nouvelle et révoquez celle que vous avez perdue.

Une clé de test consomme-t-elle mes jetons ?

Non. Une clé de test ne consomme aucun jeton et ne contacte jamais de serveur de messagerie, quelle que soit l'adresse envoyée.

Que deviennent mes clés si je supprime mon compte ?

Elles cessent toutes de fonctionner aussitôt, comme vos agents.

  • Vérifier votre première adresse

    Créez votre compte PricklyMails, confirmez-le avec le code reçu par email, puis vérifiez une première adresse dans le tableau de bord et lisez la réponse.

  • Lire un résultat de vérification

    Ce que veulent dire le verdict, la recommandation, le score et la raison d'un résultat PricklyMails, et que faire de chaque adresse avant votre envoi.

  • Vérifier une liste entière

    Vérifiez une liste en un seul lot : importez-la ou collez-la, suivez-la, téléchargez le rapport, et voyez ce que deviennent doublons et lignes invalides.

  • Jetons et offres

    La facturation en jetons : le prix de chaque contrôle, les offres et les recharges, des jetons qui n'expirent pas, et ce qui est remboursé ou jamais facturé.

  • Sécuriser votre compte

    Un mot de passe solide, l'authentification à deux facteurs, les appareils à déconnecter et les emails de sécurité : de quoi garder votre compte en main.

  • Connecter un assistant IA

    Vérifiez des adresses depuis Claude, ChatGPT, Cursor ou un autre client MCP : créez un agent, ajoutez le serveur, autorisez-le, puis révoquez-le au besoin.

  • Vos données et leur durée de conservation

    Ce que deviennent les adresses vérifiées, ce que gardent le cache partagé et votre navigateur, ce qui reste après la suppression du compte, et combien de temps.

Vérifiez votre liste avant votre prochain envoi.

1 000 jetons offerts à l'inscription, sans carte bancaire. Ensuite, vous ne payez que les réponses.