Siirry sisältöön

Verkkotunnukset

Osta, yhdistä ja hallitse verkkotunnuksia.

Avaa Verkkotunnukset
Tarkistettu koontinäyttöä vasten 18. marraskuuta 2026

Verkkotunnuksilla on kaksi metodia, jotka on tehty ulkopuolisen kutsujan käyttöön. Ne ovat ne kaksi, joita tekoälyagentti tarvitsee yhdistääkseen olemassa olevan verkkotunnuksen näkemättä koskaan nimipalvelinta: listaa se, minkä tili jo omistaa, ja osoita sitten yksi projektiin. Kaikki muu, mitä Verkkotunnukset-sivu tekee (haku, osto, DNS-tietueet, salausasetukset, analytiikka, siirrot), tehdään kojelaudasta.

Jo omistamasi verkkotunnuksen yhdistäminen

Listaa mitä sinulla on

agent_domain_list palauttaa, montako verkkotunnusta tili omistaa, ja jokaisesta sen nimen, tilan, yhteystyypin ja projektin, johon se on liitetty, jos sellainen on. Kutsu tätä ennen kuin pyydät ketään kirjoittamaan verkkotunnusta: näytä sen sijaan vaihtoehdot.

Osoita se projektiin

agent_domain_connect ottaa tämän listan domain-arvon ja valinnaisen subdomain-arvon ja liittää sen projektiin, johon kutsuva avain tai istunto on rajattu. Jätä aliverkkotunnus pois, jos haluat käyttää päätunnusta (apex). Liittäminen korvaa kaikki kyseisen isäntänimen olemassa olevat DNS-tietueet. Suosi aliverkkotunnusta, ellei henkilö halua päätunnusta.

Molemmat metodit ottavat tilin ja projektin avaimesta (tai istunnosta, jonka kautta kutsu tulee), eivät siitä, mitä kutsuja kirjoittaa pyyntöön. Yhdistäminen vaatii projektista tehdyn avaimen: avain ilman projektia voi listata mutta ei yhdistää.

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

Hylkäys palaa negatiivisella code-arvolla ja lauseella data-kentässä, esimerkiksi kun avaimeen ei ole sidottu tiliä tai projektia tai kun domain on tyhjä.

Verkkotunnuksen osto pysyy kojelaudan toimintona

agent_domain_connect ei tarkoituksella osta verkkotunnusta, vaan yhdistää vain sellaisen, jonka jo omistat. Haku ja osto pysyvät Osta verkkotunnus -ikkunan nimenomaisen vahvistuksen takana, samoin DNS-tietueiden muokkaus, salausasetukset ja siirrot.

Projektin osoitteen asettaminen

Voit antaa projektille Xudan kautta rekisteröimäsi verkkotunnuksen koodista käyttämällä metodia update_domain_setup siten, että domain_setup.type on registered ja domain_setup.registered_domain on nimi. Se on projektin oma metodi ja vaatii ylläpitäjän avaimen. Kojelauta tekee saman kohdasta Liitä projektiin.

Aiemmat oppaat

Verkkotunnukset hosting-oppaassa ja Yhdistä verkkotunnus käyvät saman tehtävän läpi vaihe vaiheelta.

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026