# Problemas comuns

Leia `status` e o motivo (campo `error`) do domínio com `GET /v1/projects/{p}/services/{s}/domains/{d}`.

| Motivo | O que significa | O que fazer |
|---|---|---|
| `no_records` | o nome não resolve | Crie os registros DNS da resposta (CNAME ou A/AAAA, mais o TXT) e espere propagar. |
| `wrong_target` | resolve, mas não para a plataforma | Ajuste o CNAME/A para os valores da resposta. |
| `proxied` | os registros estão atrás do proxy da Cloudflare | Mude para DNS only (nuvem cinza). |
| `txt_missing` | DNS correto, mas falta provar a posse | Publique `_nebular-verify.<dominio>` TXT `nebular-verify=<token>`. |
| `conflict` | ativo em outro projeto | Publique o TXT de posse: com a prova o domínio é transferido para este projeto. |
| `dns_error` | falha momentânea ao consultar DNS | Nada: a verificação repete sozinha. Espere com backoff. |

Estado `error` com `error = misconfigured`: o DNS que funcionava deixou de apontar para a plataforma; restaure os registros e o domínio reativa sozinho.

Verificação manual imediata é limitada por taxa por domínio; prefira esperar com backoff (2 s, dobrando até 30 s) a repetir em laço fechado. `429` = espere `Retry-After`.

Veja [Domínio próprio](/dominios/dominio-proprio/) e [Erros](/erros/tabela/).
