> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter registros DNS do domínio personalizado

> Obtenha os registros TXT e CNAME de que um domínio personalizado precisa para validação e SSL com GET /v2/apps/{app_id}/network/dns, para criar no registrador.

**É necessário ter um domínio personalizado já vinculado à aplicação para usar esta rota.** Domínios personalizados estão disponíveis a partir do [plano Standard](https://squarecloud.app/pt-br/pricing). Esta rota possui limite de taxa de 3 requisições a cada 10 segundos.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `apps:read`.

Esses são os registros que o Cloudflare precisa para validar a propriedade do domínio personalizado e emitir seu certificado SSL: normalmente um ou dois registros `txt` (validação do domínio e do desafio ACME) mais um registro `cname` apontando para `cname.squareweb.app`, que é o que efetivamente roteia o tráfego para a aplicação. Adicione-os no registrador do seu domínio; o Cloudflare verifica automaticamente, sem necessidade de nova solicitação.

A resposta fica em cache por 30 segundos por proprietário e aplicação, e o mesmo cache serve o agente de IA Cubic quando ele inspeciona a configuração de domínio de uma aplicação. Se o hostname personalizado ainda não tiver sido registrado na borda, a resposta é um array vazio em vez de um erro.

Para associar um domínio personalizado antes de tudo, veja [Configurar domínio personalizado](/pt-br/api-reference/endpoint/apps/network/custom). Veja também [Listar domínios](/pt-br/api-reference/endpoint/apps/domains) para todos os hostnames configurados nas suas aplicações.

## Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseField name="response" type="array">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="type" type="string">
      O tipo do registro DNS.
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome do registro DNS.
    </ResponseField>

    <ResponseField name="value" type="string">
      O valor do registro DNS.
    </ResponseField>

    <ResponseField name="status" type="string">
      O status do registro DNS. Pode ser `pending_validation`, `pending` ou `active`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
    "status": "success",
    "response": [
      {
        "type": "txt",
        "name": "_acme-challenge.example.com",
        "value": "hmo-jMx_KCWQU5CWG6xmrkI4AOZOJXlQtjEtc7zI1PA",
        "status": "pending_validation"
      },
      {
        "type": "cname",
        "name": "example.com",
        "value": "cname.squareweb.app",
        "status": "pending"
      }
    ]
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `NO_CUSTOM_DOMAIN` | 400 | A aplicação não possui um domínio personalizado associado. |

## Relacionados

* CLI: [`squarecloud app network dns`](/pt-br/cli-reference/domains#squarecloud-app-network-dns)
* SDKs: [`api.apps.network.dns()`](/pt-br/sdks/js/network) (JavaScript), [`client.apps.network.dns()`](/pt-br/sdks/py/network) (Python), [`c.Apps.Network.DNS()`](/pt-br/sdks/go/network) (Go)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.