Saltar al contenido

Domains

Compra, conecta y gestiona dominios.

Abrir Domains
Comprobado con el panel el 18 de noviembre de 2026

Domains tiene dos métodos pensados para un llamador externo. Son los dos que necesita un agente de IA para conectar un dominio existente sin ver nunca un servidor de nombres: listar lo que la cuenta ya posee y luego apuntar uno a un proyecto. Todo lo demás que hace la página de Domains (buscar, comprar, registros DNS, ajustes de cifrado, analíticas, transferencias) se ejecuta desde el panel.

Conectar un dominio que ya tienes

Lista lo que tienes

agent_domain_list devuelve cuántos dominios tiene la cuenta y, de cada uno, su nombre, su estado, su tipo de conexión y el proyecto al que está asociado, si lo hay. Llámalo antes de pedir a nadie que escriba un dominio: presenta las opciones en su lugar.

Apúntalo a un proyecto

agent_domain_connect toma un domain de esa lista y un subdomain opcional, y lo asocia al proyecto al que está limitada la clave o sesión que llama. Omite el subdominio para usar el apex. Asociar reemplaza cualquier registro DNS existente en ese nombre de host exacto. Prefiere un subdominio salvo que la persona quiera el apex.

Ambos métodos toman la cuenta y el proyecto de la clave (o de la sesión por la que llega la llamada), no de lo que escribe el llamador en la petición. Conectar necesita una clave creada desde un proyecto: una clave sin proyecto puede listar, pero no puede conectar.

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'},
)

Un rechazo llega con un code negativo y una frase en data, por ejemplo cuando no hay ninguna cuenta o ningún proyecto asociado a la clave, o cuando el domain está vacío.

Comprar un dominio sigue siendo una acción del panel

agent_domain_connect deliberadamente no compra un dominio, solo conecta uno que ya tienes. La búsqueda y la compra siguen detrás de una confirmación explícita en la ventana Comprar un dominio, junto con la edición de registros DNS, los ajustes de cifrado y las transferencias.

Definir la dirección de un proyecto

Para dar a un proyecto un dominio que registraste a través de Xuda desde código, usa update_domain_setup con domain_setup.type en registered y domain_setup.registered_domain con el nombre. Es un método del propio proyecto y necesita una clave de administrador. El panel hace lo mismo desde Asociar a un proyecto.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026