# Domínio próprio

> Cadastre um domínio próprio (go.suamarca.com.br) para links curtos com a sua marca e código personalizado.

Fonte: https://curtei.com/docs/api/dominios

Endpoint: `POST https://api.curtei.com/v1/domains`
Escopo: `domains:manage`

```bash
curl -X POST https://api.curtei.com/v1/domains \
  -H "Authorization: Bearer $CURTEI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"hostname": "go.minhaloja.com.br", "not_found_url": "https://minhaloja.com.br"}'
```

1. A resposta traz as instruções de DNS: um registro TXT `_encurtador-verify.<seu domínio>` (prova de posse) e um CNAME para o tráfego.
2. Crie os registros no seu provedor de DNS e chame `POST /domains/{id}/verify`.
3. Com o domínio ativo, o certificado HTTPS é emitido sozinho no primeiro acesso.

- `PATCH /domains/{id}` muda `not_found_url` (para onde vão códigos inexistentes) e `is_default` (links sem `domain` passam a usar este).
- No domínio próprio você escolhe o `slug` dos links.
- `DELETE /domains/{id}` só funciona sem links no domínio (`409 domain_in_use`).
- Um cadastro pendente não reserva o domínio: verifique em até 7 dias.