Vai al contenuto

Domains

Acquista, collega e gestisci i domini.

Apri Domains
Verificato rispetto alla dashboard il 18 novembre 2026

Domains ha due metodi pensati per un chiamante esterno. Sono i due di cui un agente IA ha bisogno per collegare un dominio esistente senza vedere mai un nameserver: elencare ciò che l'account possiede già, poi farne puntare uno a un progetto. Tutto il resto che fa la pagina Domains (ricerca, acquisto, record DNS, impostazioni di crittografia, analisi, trasferimenti) si svolge dalla dashboard.

Collegare un dominio che possiedi già

Elenca ciò che hai

agent_domain_list restituisce quanti domini possiede l'account e, per ciascuno, il suo nome, lo stato, il tipo di collegamento e il progetto a cui è collegato, se ce n'è uno. Chiamalo prima di chiedere a qualcuno di digitare un dominio: presenta invece le opzioni.

Fallo puntare a un progetto

agent_domain_connect prende un domain da quell'elenco e un subdomain facoltativo, e lo collega al progetto a cui è limitata la chiave o la sessione che chiama. Ometti il sottodominio per usare l'apex. Il collegamento sostituisce qualsiasi record DNS esistente su quell'esatto hostname. Preferisci un sottodominio a meno che la persona non voglia l'apex.

Entrambi i metodi prendono l'account e il progetto dalla chiave (o dalla sessione attraverso cui arriva la chiamata), non da ciò che il chiamante scrive nella richiesta. Collegare richiede una chiave creata da un progetto: una chiave senza progetto può elencare, ma non può collegare.

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 rifiuto torna con un code negativo e una frase in data, per esempio quando nessun account o nessun progetto è associato alla chiave, o quando il domain è vuoto.

Acquistare un dominio resta un'azione della dashboard

agent_domain_connect di proposito non acquista un dominio, ne collega solo uno che già possiedi. Ricerca e acquisto restano dietro una conferma esplicita nella finestra Acquista un dominio, insieme alla modifica dei record DNS, alle impostazioni di crittografia e ai trasferimenti.

Impostare l'indirizzo di un progetto

Per dare a un progetto, da codice, un dominio che hai registrato tramite Xuda, usa update_domain_setup con domain_setup.type impostato su registered e domain_setup.registered_domain impostato sul nome. È un metodo del progetto stesso e richiede una chiave amministratore. La dashboard fa lo stesso da Collega a un progetto.

Guide precedenti

Domini nella guida all'hosting e Collegare un dominio percorrono lo stesso lavoro passo dopo passo.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026