Un domaine ne se résume pas à ses enregistrements DNS.

On enregistre un domaine pour en faire quelque chose : publier un site, orienter les visiteurs, prouver sa propriété ou suivre son renouvellement. Le DNS est essentiel, mais il ne représente qu’une partie du travail. IaGenify SDK 0.3.1 enrichit la ressource domaine autour des tâches réellement effectuées.

Rattacher un nom à un projet hébergé

Un projet peut être rattaché à la racine du domaine ou à un sous-domaine. La ressource renvoie ensuite ses rattachements ; détacher un sous-domaine ne demande pas de reconstruire soi-même toute la logique des enregistrements.

const domain = await api.domains.get("example.com");
await domain.attach({ host: site.id });
await domain.attach({ host: endpoint.id, name: "api" });
const connected = await domain.attachments();

Cette approche sépare l’intention de la plomberie. L’application demande de rattacher `api.example.com` à un hébergement ; la plateforme coordonne le routage DNS et l’hébergement. Un enregistrement seul ne dit pas au service d’hébergement quel projet doit répondre.

Une redirection est une opération différente

Un CNAME n’est pas une redirection de navigateur. Le CNAME agit sur la résolution DNS ; une redirection renvoie une réponse HTTP qui conduit le visiteur vers une autre URL, éventuellement en conservant le chemin et la requête.

await domain.redirects.add({ from: "www", to: "@" });
const rules = await domain.redirects.list();

Cette distinction compte en production : les règles ne s’appliquent qu’au trafic qui atteint le service chargé de les exécuter. L’API rend cette condition visible au lieu de modifier silencieusement le mode de service du nom.

Comprendre l’état du domaine

Un domaine possède aussi un cycle de vie. Le SDK peut lire les données de propriété publiées par le registre, repérer les échéances proches, consulter TLS, gérer l’état DNSSEC et créer des vérifications TXT pour des services.

Certaines informations dépendent de ce que publient le registre ou le registrar. Si une échéance n’est pas connue, l’API peut l’indiquer comme inconnue plutôt que d’inventer une date.

Le DNS reste disponible, avec davantage de contexte

La gestion directe des enregistrements DNS reste possible. La différence est que chaque tâche de domaine dispose maintenant de son opération : rattacher un projet, créer une redirection, vérifier TLS ou confirmer un service.

Un domaine est un nom utilisé par des personnes, un service auquel on le rattache et un cycle de vie à suivre. Le DNS n’en est qu’une partie importante.

Pour les tableaux de bord, les automatisations de déploiement et les workflows qui gèrent des domaines, cette ressource exprime les opérations courantes sans réduire toute l’expérience à une liste d’enregistrements.