Gå til indhold

Domæner

Køb, forbind og administrer domæner.

Åbn Domæner
Kontrolleret mod dashboardet den 18. november 2026

Domæner har to metoder, der er bygget til en ekstern kalder. Det er de to, en AI-agent har brug for for at forbinde et eksisterende domæne uden nogensinde at se en nameserver: list det, kontoen allerede ejer, og peg derefter et på et projekt. Alt det andet, siden Domæner gør (søg, køb, DNS-records, krypteringsindstillinger, analyser, overførsler), kører fra dashboardet.

Forbind et domæne, du allerede ejer

List det, du har

agent_domain_list returnerer, hvor mange domæner kontoen har, og for hvert af dem dets navn, status, forbindelsestype og det projekt, det er knyttet til, hvis der er et. Kald den, før du nogensinde beder nogen om at skrive et domæne: vis mulighederne i stedet.

Peg det på et projekt

agent_domain_connect tager et domain fra den liste og et valgfrit subdomain og knytter det til det projekt, den kaldende nøgle eller session er afgrænset til. Udelad subdomænet for at bruge apex-domænet. At knytte erstatter enhver eksisterende DNS-record på netop det værtsnavn. Foretræk et subdomæne, medmindre personen vil have apex-domænet.

Begge metoder henter kontoen og projektet fra nøglen (eller fra den session, kaldet kommer gennem), ikke fra det, kalderen skriver i anmodningen. At forbinde kræver en nøgle, der er lavet fra et projekt: en nøgle uden projekt kan liste, men ikke forbinde.

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

En afvisning kommer tilbage med en negativ code og en sætning i data, for eksempel når ingen konto eller intet projekt er bundet til nøglen, eller når domain er tomt.

At købe et domæne forbliver en handling i dashboardet

agent_domain_connect køber bevidst ikke et domæne, den forbinder kun et, du allerede har. Søgning og køb forbliver bag en eksplicit bekræftelse i vinduet Køb et domæne, sammen med redigering af DNS-records, krypteringsindstillinger og overførsler.

At sætte et projekts adresse

For fra kode at give et projekt et domæne, du har registreret gennem Xuda, skal du bruge update_domain_setup med domain_setup.type sat til registered og domain_setup.registered_domain sat til navnet. Det er en metode på selve projektet og kræver en admin-nøgle. Dashboardet gør det samme fra Tilknyt til et projekt.

Tidligere guides

Domæner i hostingguiden og Tilslut et domæne gennemgår den samme opgave trin for trin.

Hvordan er denne guide?

Sidst opdateret den 19. november 2026