L’API de délivrabilité e-mail.

curl -X POST https://api.unspam.email/ext/v2/spam-check \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# renvoie l’id du test et l’adresse d’envoi
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# envoyez votre e-mail à cette adresse, puis lisez le résultat
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# réponse (200)
{
  "status": "completed",
  "score": 84,
  "results": [
    { "id": "spf", ... },
    { "id": "dkim", ... }
  ]
}

curl -X POST https://api.unspam.email/ext/v2/inbox-placement \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# renvoie l’id du test et les boîtes témoins à qui envoyer
{
  "id": "7Hq2xLpV0aKd",
  "mailboxes": [
    { "id": 12, "name": "Gmail", "address": ... },
    { "id": 31, "name": "Outlook", "address": ... }
  ]
}

# envoyez à chaque adresse avec l’id du test dans l’objet ou le corps, puis lisez le résultat
curl https://api.unspam.email/ext/v2/inbox-placement/7Hq2xLpV0aKd \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

curl -X POST https://api.unspam.email/ext/v2/client-previews \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email_source": "raw-data",
    "subject": "Your order shipped",
    "body": "<html>...</html>",
    "devices": ["iphone_15_pro_dm"]
  }'

# interrogez l’id jusqu’à ce que status soit completed
{
  "id": "3f9a2c8e-1d4b-4c7a-9f2e-7b1e5da0c62f",
  "status": "pending",
  "previews": [
    { "device_key": "iphone_15_pro_dm", "status": "pending", ... }
  ]
}

curl -X POST https://api.unspam.email/ext/v2/email-verification/instant-checks \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "jane@acme.com" }'

# interrogez l’id jusqu’à la fin de la vérification
{
  "email": "jane@acme.com",
  "status": "completed",
  "result": {
    "status": "deliverable",
    "reason": "accepted",
    "action": "keep"
  }
}

curl -X POST https://api.unspam.email/ext/v2/dmarc/domains \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "yourdomain.com" }'

# publiez cet enregistrement TXT, puis appelez verify
{
  "domain": { "status": "pending_dns", ... },
  "dns_instructions": {
    "host": "_dmarc.yourdomain.com",
    "type": "TXT",
    "value": "v=DMARC1; p=none; rua=mailto:reports+a1b2c3d4@dmarc.unspam.email"
  }
}

curl -X POST https://api.unspam.email/ext/v2/scheduled-tests \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# envoyez votre e-mail à inbox_address, puis définissez la programmation
{
  "id": "9c41e7a2-52bd-4f0e-a6c3-1d8e0b7f3a64",
  "status": "draft",
  "inbox_address": "test-xyz@check.unspam.email"
}

# une fois lancé, lisez les résultats de chaque exécution
curl https://api.unspam.email/ext/v2/scheduled-tests/9c41e7a2-52bd-4f0e-a6c3-1d8e0b7f3a64/runs \
  -H "Authorization: Bearer $UNSPAM_TOKEN"