Risoluzione dei problemi del dominio

Inizia con la CLI, che controlla ogni record in tempo reale:

spacepost domains doctor acme.com

Oppure confronta a mano con 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

Il dominio resta pending o not_started

Causa	Soluzione
I record non sono ancora stati creati, oppure il DNS non si è propagato	Attendi da 10 a 30 minuti, poi chiama POST /domains/{id}/verify. TTL di un’ora o più possono ritardarlo.
Nome del dominio duplicato (a1b2._domainkey.acme.com.acme.com)	Il tuo provider DNS aggiunge automaticamente il dominio; inserisci solo il nome relativo (a1b2._domainkey). Controlla con dig.
Nome senza il dominio (a1b2._domainkey non è risolvibile)	Il tuo provider richiede il nome completo (a1b2._domainkey.acme.com), frequente con Route 53.
Proxy di Cloudflare attivo	I record CNAME per DKIM devono essere solo DNS (nuvola grigia), non in proxy.
Punto finale o spazi superflui nel valore	Incolla di nuovo il valore esattamente.
Virgolette attorno al valore TXT	Inserisci il valore senza virgolette.
Record esistente in conflitto su send	Un CNAME su send.acme.com non può coesistere con MX/TXT. Usa un return path personalizzato diverso.
Due record SPF sullo stesso nome	Uniscili in un unico valore TXT. È consentito un solo record v=spf1 per nome.

Il dominio è passato a failed

SpacePost rinuncia a un dominio il cui DNS non è comparso dopo 72 ore. Correggi i record, poi richiama verify; lo stato torna a pending e poi a verified.

invalid_from_address

403 invalid_from_address: “The example.com domain is not verified.” Il dominio in from deve essere un dominio verificato nel tuo team, o un suo sottodominio. Controlla di non avere refusi e di non usare la chiave API del team sbagliato.

Domain already registered

Un dominio può appartenere a un solo team. Se hai registrato di nuovo un dominio dopo aver lasciato un vecchio team, eliminalo prima lì oppure contatta l’assistenza.

Return path verificato ma DMARC fallisce

Apri gli header di un messaggio ricevuto (Gmail: Mostra originale) e controlla Authentication-Results. Dovresti vedere dkim=pass header.d=acme.com e spf=pass con smtp.mailfrom=send.acme.com. Se SPF mostra amazonses.com, i record del return path mancano o non sono ancora verificati.

Ancora bloccato

Scrivi a support@spacepost.dev indicando il nome del dominio e l’output di spacepost domains doctor.