L’API

Essayer dans le bac à sable → Chaque endpoint dispose d’un bouton qui l’exécute sur le service en production. Rien ici ne nécessite de clé, donc toute requête lancée depuis cette page est réelle : elle réserve une adresse réelle et elle est comptabilisée.

La boucle

Deux requêtes et un e-mail. Le troisième appel n’est nécessaire que parce que l’analyse prend quelques secondes.

1. Réserver une adresse

   Envoyez une requête POST au point de terminaison de la boîte de réception. Vous recevez une adresse qui accepte exactement un message et expire au bout d’une heure, ainsi que le slug servant de clé pour tout le reste.

2. Lui envoyer le message réel

   Via SMTP, depuis la plateforme qui enverra la campagne. La moitié des contrôles lisent les en-têtes ajoutés par votre plateforme d’envoi, donc un message composé à la main mesure autre chose.

3. Interroger le statut, puis consulter le rapport

   Le point de terminaison de statut ne représente que quelques centaines d’octets et vous indique si le rapport complet peut déjà être récupéré. Le rapport lui-même compte plusieurs milliers de lignes.

# 1. reserve a single-use address
curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en'

{
  "address": "test-<slug>@t.email-spam-tester.com",
  "slug": "<slug>",
  "expires_at": "2026-01-01T12:00:00Z"
}

# 2. send your message to that address, then poll
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

{
  "slug": "<slug>",
  "analysis_status": "checks_ready",
  "ai_status": "running",
  "checks_done": 39,
  "checks_total": 39
}

# 3. read the report once analysis_status is checks_ready
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>'

{
  "report_url": "https://email-spam-tester.com/t/<slug>",
  "score_ours": 86.4,
  "score_compat": 9.2,
  "subscores": {"auth": 100.0, "infra_spam": 78.1, "content": 92.0, "compliance": 75.0},
  "complete": true,
  "checks": [
    {
      "id": "auth.dmarc",
      "status": "warn",
      "title": "DMARC result",
      "summary": "DMARC passes, but the policy is p=none.",
      "weight_ours": -4.0,
      "evidence": {"policy": "none", "aligned": "dkim"},
      "citations": {"standards": [{"title": "RFC 9989 §4.7", "quote": "..."}]}
    }
  ],
  "fixes": [
    {"id": "dmarc-enforce", "gain_ours": 4.0, "gain_compat": 0.0,
     "fix": {"title": "Move DMARC to quarantine", "severity": "medium"}}
  ]
}

Authentification

Il n’y en a aucune. Aucune clé à demander, aucun en-tête à définir, aucun compte à créer. Le slug que vous recevez constitue la capacité d’accès : quiconque le détient peut lire ce rapport, et personne d’autre ne peut le deviner.

Points de terminaison

Adresse de base https://email-spam-tester.com. Toutes les réponses sont au format JSON.

Lecture du rapport

Les champs qui contiennent la réponse, dans l'ordre où vous en aurez probablement besoin.

Statuts

Une vérification peut avoir l’un de cinq états, et la différence entre deux d’entre eux est plus importante qu’il n’y paraît.

analysis_status prend les valeurs received, analyzing, checks_ready, failed. ai_status prend les valeurs pending, running, ready, fallback, error. Le rapport déterministe est définitif à checks_ready ; ai_status ajoute uniquement le plan.

Ce qui peut être renvoyé

Quatre choses à savoir

Pour les machines

• /api/openapi.json La description OpenAPI, générée à partir du même code que celui qui sert l’API.
• /llms.txt, /llms-full.txt Une carte succincte de ce site pour les modèles de langage, selon la convention llms.txt, et une version plus longue regroupant la boucle complète et les champs du rapport dans un seul fichier.
• /mcp Un serveur MCP offrant la même fonctionnalité et une attente bloquante, ce qui est préférable à l’interrogation répétée depuis un modèle.
• For agents La page destinée aux agents : quand utiliser cet outil, comment interpréter un contrôle ignoré par rapport à un contrôle réussi, et quels constats concernent des enregistrements DNS qu’une personne doit modifier plutôt que du texte qu’un agent peut éditer.