Registramos un dominio para usarlo: publicar un sitio, dirigir visitantes, demostrar titularidad o controlar su renovación. El DNS es esencial, pero solo es una parte del trabajo. IaGenify SDK 0.3.1 amplía el recurso de dominio para cubrir las tareas que las personas realizan de verdad.
Vincula un nombre con un proyecto alojado
Un proyecto puede vincularse con la raíz del dominio o con un subdominio. El recurso muestra los vínculos activos; separar un subdominio no obliga a reconstruir manualmente toda la lógica de registros.
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();Así se separa la intención de la infraestructura. La aplicación pide vincular `api.example.com` a un host y la plataforma coordina el DNS y el servicio de hosting. Un registro por sí solo no indica qué proyecto debe responder por el nombre.
Una redirección es una operación distinta
Un CNAME no es una redirección del navegador. El CNAME afecta la resolución DNS; una redirección devuelve una respuesta HTTP que lleva al visitante a otra URL y puede conservar la ruta y la consulta.
await domain.redirects.add({ from: "www", to: "@" });
const rules = await domain.redirects.list();La diferencia importa en producción: las reglas solo funcionan con el tráfico que llega al servicio que las aplica. La API muestra esa condición en vez de cambiar en silencio cómo se sirve el nombre.
Conoce el estado del dominio
Un dominio también tiene un ciclo de vida. El SDK puede leer los datos de titularidad publicados por el registro, detectar vencimientos próximos, consultar TLS, gestionar DNSSEC y crear verificaciones TXT para servicios.
Algunos datos dependen de lo que publiquen el registro y el registrador. Si no se conoce el vencimiento, la API puede indicarlo como desconocido en vez de inventar una fecha.
El DNS sigue disponible, con más contexto
La gestión directa de registros DNS sigue siendo posible. Ahora cada tarea tiene una operación propia: vincular un proyecto, crear una redirección, consultar TLS o verificar un servicio.
Un dominio es un nombre que las personas usan, un servicio al que lo conectan y un ciclo de vida que deben mantener. DNS es una parte importante, no todo el dominio.
Para paneles de cuenta, automatizaciones de despliegue y workflows, el recurso expresa tareas habituales sin reducir toda la experiencia a una lista de registros.
Preguntas frecuentes
¿`attach()` sustituye la gestión DNS?
No. Expresa la relación entre un dominio y un proyecto alojado; los registros siguen disponibles directamente.
¿Una redirección es lo mismo que un CNAME?
No. El CNAME afecta al DNS; una redirección es una respuesta HTTP que envía al visitante a otra URL.
¿El SDK permite comprar o renovar dominios?
Esta función gestiona dominios ya conectados a IaGenify; no implica que la compra o renovación con un registrador esté disponible.
¿Qué ocurre si no se conoce el vencimiento?
La API puede indicar que el registro no publica esa información, en lugar de presentar una estimación como un hecho.