Dépannage des domaines

Commencez par la CLI, qui interroge chaque enregistrement en direct :

spacepost domains doctor acme.com

Ou comparez à la main avec dig :

dig +short CNAME a1b2c3d4e5f6._domainkey.acme.com
dig +short MX send.acme.com
dig +short TXT send.acme.com
dig +short TXT _dmarc.acme.com

Le domaine reste pending ou not_started

Cause	Solution
Enregistrements pas encore créés, ou DNS non propagé	Attendez 10 à 30 minutes, puis appelez POST /domains/{id}/verify. Des TTL d’une heure ou plus peuvent retarder la propagation.
Nom de domaine doublé (a1b2._domainkey.acme.com.acme.com)	Votre fournisseur DNS ajoute le domaine automatiquement ; saisissez uniquement le nom relatif (a1b2._domainkey). Vérifiez avec dig.
Domaine absent du nom (a1b2._domainkey est irrésolvable)	Votre fournisseur a besoin du nom complet (a1b2._domainkey.acme.com), fréquent avec Route 53.
Proxy Cloudflare activé	Les enregistrements CNAME de DKIM doivent être en DNS only (nuage gris), pas en proxy.
Point final ou espace parasite dans la valeur	Recollez exactement la valeur.
Guillemets autour de la valeur TXT	Saisissez la valeur sans guillemets.
Enregistrement existant en conflit sur send	Un CNAME sur send.acme.com ne peut pas coexister avec MX/TXT. Utilisez un autre return path personnalisé.
Deux enregistrements SPF sur le même nom	Fusionnez-les en une seule valeur TXT. Un seul enregistrement v=spf1 par nom est autorisé.

Le domaine est passé à failed

SpacePost abandonne un domaine dont le DNS n’est pas apparu après 72 heures. Corrigez les enregistrements, puis rappelez verify ; le statut repasse à pending, puis à verified.

invalid_from_address

403 invalid_from_address : « The example.com domain is not verified. » Le domaine de from doit être un domaine vérifié de votre équipe, ou un sous-domaine d’un tel domaine. Vérifiez les fautes de frappe et que vous n’utilisez pas la clé API d’une autre équipe.

Domain already registered

Un domaine ne peut appartenir qu’à une seule équipe. Si vous avez réenregistré un domaine après avoir quitté une ancienne équipe, supprimez-le d’abord là-bas ou contactez le support.

Le return path est vérifié mais DMARC échoue

Ouvrez les en-têtes d’un message reçu (Gmail : Afficher l’original) et vérifiez Authentication-Results. Vous voulez dkim=pass header.d=acme.com et spf=pass avec smtp.mailfrom=send.acme.com. Si SPF affiche amazonses.com, les enregistrements du return path sont manquants ou pas encore vérifiés.

Toujours bloqué

Écrivez à support@spacepost.dev avec le nom du domaine et la sortie de spacepost domains doctor.