Aller au contenu

Démarrage

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.

https://api.pricklymails.com

Votre première vérification

Soumettez une adresse à POST /api/verify avec votre clé API en bearer. 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.

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 :

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

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