Aller au contenu
Nexus TéléchargerDémarrer

Noms de domaine

3 outils. Chacun rejoue une route de l’API avec vos droits.

nexus_list_domains Le parc de noms de domaine lecture

TOUS les noms de domaine du parc en une réponse, avec pour chacun : ce qu’il sert (site, client, projet), le compte d’hébergeur qui le porte, sa date de création au registre, son échéance ET la source de cette échéance, si le renouvellement automatique est armé, et l’adresse vers laquelle il pointe RÉELLEMENT — avec le nom de la machine du parc quand c’en est une. Ne coûte AUCUN appel chez l’hébergeur : tout vient du cache et de sources publiques relevées chaque jour. À préférer à nexus_list_provider_resources dès qu’on raisonne sur des domaines plutôt que sur des ressources. Deux pièges à ne pas retourner à l’utilisateur : « créé le » est la date de création AU REGISTRE et non la date d’achat par le client — un domaine repris en 2024 mais créé en 2009 porte 2009 ; et « INCONNU » veut dire que la résolution n’a pas abouti, JAMAIS que le domaine est mort.

  • clientId texte, facultatif — Les domaines qui servent ce client
  • siteId texte, facultatif — Ceux qui servent ce site
  • connectionId texte, facultatif — Ceux d’un compte d’hébergeur (nexus_list_provider_connections)
  • unbound booléen, facultatif — Seulement ceux qui ne servent rien de connu — le travail qui reste
  • expiringDays nombre, facultatif — Ceux dont l’échéance tombe dans N jours. Écarte ceux dont on ignore l’échéance
  • noAutoRenew booléen, facultatif — Seulement ceux dont le renouvellement automatique est explicitement DÉSARMÉ. Ceux dont on ne sait rien ne sont pas dedans
  • includeUnmanaged booléen, facultatif — Inclure les domaines qu’aucun compte relié ne porte, déduits des adresses des sites. Vrai par défaut : les exclure ferait croire que le parc se limite à un hébergeur
  • q texte, facultatif — Filtre : nom, registraire, adresse, machine
  • page nombre, facultatif
  • size nombre, facultatif — 50 par défaut
nexus_get_domain La fiche d’un nom de domaine lecture

Tout ce que Nexus sait d’UN domaine, en un appel et sans toucher l’hébergeur : le contrat (statut, verrous de domaine et de transfert, DNSSEC, renouvellement), les serveurs de noms DÉCLARÉS par l’hébergeur et ceux RÉELLEMENT délégués vus par le résolveur, les adresses de l’apex et de www, les certificats du même domaine, et deux listes à lire avant de proposer quoi que ce soit : « gaps » dit ce qu’aucune source n’a rendu et pourquoi, « limites » dit ce que le fournisseur ne sait PAS faire — notamment qu’IONOS ne permet de créer aucune boîte aux lettres. Ne jamais annoncer une capacité qui n’est pas là ; ne jamais aller la chercher ailleurs. Pour le contenu de la zone, c’est nexus_list_dns_records sur « zoneResourceId ».

  • domain texte — Le nom, ex. « client.fr ». Un sous-domaine est ramené à sa racine
nexus_plan_subdomain Préparer un sous-domaine écrit agit hors de Nexus

Calcule l’aperçu de la création d’un sous-domaine (« blog » sur « client.fr » donne « blog.client.fr ») SANS RIEN APPLIQUER. Un sous-domaine n’est pas un objet : c’est un enregistrement DNS, et cet outil ne fait que composer l’intention avant de la passer par le même chemin que tout le reste. Il rend un changeId et un planHash à appliquer par nexus_apply_dns_change sur « zoneResourceId » — jamais une intention réécrite. La cible « APEX » vise la même adresse que le domaine lui-même, ce qui est le cas courant ; « SERVEUR » vise une machine du parc par son identifiant, ce qui vaut mieux qu’une adresse recopiée à la main. Si le nom existe déjà à l’identique, « dejaConfigure » est vrai et il n’y a rien à faire — ne pas rejouer. S’il porte déjà autre chose, « conflit » le dit et RIEN n’est écrasé : demander à l’utilisateur.

  • domain texte — Le domaine, ex. « client.fr »
  • label texte — L’étiquette SEULE, ex. « blog ». Jamais le nom complet
  • cible valeur — Où pointe le sous-domaine
  • ttl nombre, facultatif — 3600 par défaut