Saltar para o conteúdo

Domains

Compre, ligue e gira domínios.

Abrir Domains
Verificado com o painel em 18 de novembro de 2026

Os Domínios têm dois métodos pensados para um chamador externo. São os dois de que um agente de IA precisa para ligar um domínio existente sem nunca ver um servidor de nomes: listar o que a conta já possui e depois apontar um para um projeto. Tudo o resto que a página dos Domínios faz (pesquisa, compra, registos DNS, definições de encriptação, análises, transferências) é feito a partir do painel.

Ligar um domínio que já possui

Listar o que tem

agent_domain_list devolve quantos domínios a conta tem e, para cada um, o seu nome, estado, tipo de ligação e o projeto a que está associado, se houver. Chame-o antes de pedir a alguém que escreva um domínio: apresente as opções em vez disso.

Apontá-lo para um projeto

agent_domain_connect recebe um domain dessa lista e um subdomain opcional, e associa-o ao projeto a que a chave ou a sessão que chama está limitada. Omita o subdomínio para usar o apex. Associar substitui qualquer registo DNS existente nesse nome de anfitrião exato. Prefira um subdomínio, a menos que a pessoa queira o apex.

Ambos os métodos tiram a conta e o projeto da chave (ou da sessão por onde a chamada chega), e não do que o chamador escreve no pedido. Ligar precisa de uma chave criada a partir de um projeto: uma chave sem projeto pode listar, mas não pode ligar.

curl -s https://xuda.ai/cpi/agent_domain_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY"}'

curl -s https://xuda.ai/cpi/agent_domain_connect \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","domain":"example.com","subdomain":"app"}'
const res = await fetch('https://xuda.ai/cpi/agent_domain_connect', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', domain: 'example.com', subdomain: 'app' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/agent_domain_connect',
    json={'api_key': 'YOUR_API_KEY', 'domain': 'example.com', 'subdomain': 'app'},
)

Uma recusa volta com um code negativo e uma frase em data, por exemplo quando nenhuma conta ou nenhum projeto está associado à chave, ou quando o domain está vazio.

Comprar um domínio continua a ser uma ação do painel

agent_domain_connect deliberadamente não compra um domínio, apenas liga um que já possui. A pesquisa e a compra ficam atrás de uma confirmação explícita na janela Comprar um domínio, tal como a edição de registos DNS, as definições de encriptação e as transferências.

Definir o endereço de um projeto

Para dar a um projeto, a partir de código, um domínio que registou através do Xuda, use update_domain_setup com domain_setup.type definido como registered e domain_setup.registered_domain definido como o nome. É um método do próprio projeto e precisa de uma chave de administrador. O painel faz o mesmo a partir de Associar a um projeto.

Guias anteriores

Domínios no guia de alojamento e Ligar um domínio percorrem a mesma tarefa passo a passo.

Que tal está este guia?

Última atualização em 16 de novembro de 2026