Vue d'ensemble de l'API

PricklyMails vérifie la délivrabilité des emails via une API REST : syntaxe, MX, SMTP, détection jetable et rôle, suggestions de typo, et vérification en masse, le tout facturé depuis un portefeuille de jetons.

URL de base

https://api.pricklymails.com

Authentification

Deux types d'identifiants distincts couvrent l'API, selon ce que vous appelez :

• Clé API (Authorization: Bearer pm_live_... ou pm_test_...) : authentifie les endpoints de vérification facturables (/api/verify, /api/batches, ...). Voir Authentification.
• Jeton d'accès JWT : authentifie les endpoints du dashboard (gestion des clés API, portefeuille, abonnement, webhooks) depuis votre session connectée. Voir Clés API.

Conventions

• Chaque corps de requête et de réponse est en JSON.
• Les endpoints de liste paginés acceptent des paramètres de query limit et offset, et renvoient dans la réponse les valeurs effectives (après plafonnement).
• Les horodatages sont des chaînes RFC 3339 en UTC.
• Un UUID de ressource appartenant à autrui renvoie le même 404 qu'un UUID inconnu : la propriété n'est jamais révélée.
• Chaque erreur porte une clé de traduction stable plutôt que du texte localisé.

Étapes suivantes

• Démarrage : soumettez votre première vérification.
• Authentification : le format des clés API et le mode bac à sable.
• Clés API : créez et gérez vos clés depuis le dashboard.
• Vérifier un email : chaque contrôle et ce que signifie le verdict.
• Batches : la vérification en masse.
• Webhooks : soyez notifié plutôt que d'interroger.
• Facturation : plans, portefeuille de jetons et tarification.
• Limites de débit : la limitation par clé.
• Erreurs : la forme des erreurs et les codes de statut.