Aller au contenu

Démarrage

Vérifiez votre première adresse email avec l'API PricklyMails en quelques minutes : créez une clé, soumettez un job, et lisez le verdict et le score.

L'API PricklyMails vérifie les adresses email en temps réel : syntaxe, enregistrements MX, délivrabilité SMTP, détection jetable et rôle, et suggestions de typo, le tout renvoyé sous forme de verdict de délivrabilité et de score de qualité.

URL de base

Toutes les requêtes vont vers une seule URL de base, en HTTPS.

TEXT
https://api.pricklymails.com

Votre première vérification

  1. Soumettre l'adresse

    Soumettez une adresse à POST /api/verify avec votre clé API en bearer.

    Requête
    curl -X POST https://api.pricklymails.com/api/verify \
  -H "Authorization: Bearer pm_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{ "email": "quelquun@example.com" }'

    La réponse porte l'UUID du job et un en-tête Location pointant vers l'URL d'interrogation :

    Réponse
    {
    "job_uuid": "6f1c...",
    "status": "queued",
    "estimated_cost": 7
}

  2. Interroger le résultat

    La vérification est asynchrone : l'appel renvoie un job_uuid, et vous interrogez GET /api/verify/{uuid} jusqu'à ce que le job atteigne un statut terminal. Interrogez le job jusqu'à ce qu'il soit completed, puis lisez le résultat par contrôle et le score. Vous préférez être notifié plutôt qu'interroger ? Enregistrez un webhook.

Étapes suivantes