Aller au contenu

Domains

Achetez, connectez et gérez des domaines.

Ouvrir Domains
Vérifié par rapport au tableau de bord le 18 novembre 2026

Domains a deux méthodes conçues pour un appelant externe. Ce sont les deux dont un agent IA a besoin pour connecter un domaine existant sans jamais voir un serveur de noms : lister ce que le compte possède déjà, puis en faire pointer un vers un projet. Tout le reste de ce que fait la page Domains (recherche, achat, enregistrements DNS, paramètres de chiffrement, statistiques, transferts) se fait depuis le tableau de bord.

Connecter un domaine que vous possédez déjà

Lister ce que vous avez

agent_domain_list renvoie le nombre de domaines que le compte détient et, pour chacun, son nom, son statut, son type de connexion et le projet auquel il est rattaché, le cas échéant. Appelez-la avant de demander à quiconque de saisir un domaine : présentez plutôt les options.

Le faire pointer vers un projet

agent_domain_connect prend un domain de cette liste et un subdomain facultatif, et le rattache au projet auquel la clé ou la session appelante est limitée. Omettez le sous-domaine pour utiliser le domaine racine. Le rattachement remplace tout enregistrement DNS existant sur ce nom d'hôte exact. Préférez un sous-domaine, sauf si la personne veut le domaine racine.

Les deux méthodes prennent le compte et le projet à partir de la clé (ou de la session par laquelle passe l'appel), et non de ce que l'appelant écrit dans la requête. Se connecter demande une clé créée depuis un projet : une clé sans projet peut lister, mais ne peut pas connecter.

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 refus revient avec un code négatif et une phrase dans data, par exemple quand aucun compte ou aucun projet n'est lié à la clé, ou quand le domain est vide.

Acheter un domaine reste une action du tableau de bord

agent_domain_connect n'achète volontairement pas de domaine : il ne connecte que celui que vous détenez déjà. La recherche et l'achat restent derrière une confirmation explicite dans la fenêtre Acheter un domaine, tout comme la modification des enregistrements DNS, les paramètres de chiffrement et les transferts.

Définir l'adresse d'un projet

Pour donner à un projet un domaine que vous avez enregistré via Xuda depuis du code, utilisez update_domain_setup avec domain_setup.type à registered et domain_setup.registered_domain au nom du domaine. C'est une méthode du projet lui-même, et elle demande une clé d'administrateur. Le tableau de bord fait la même chose depuis Rattacher à un projet.

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026