Web Hosting

Web Hosting es el recurso que sube un sitio web estático ya compilado a un Space y lo sirve en la dirección {subdomain}.weegloo.app. Tomando como ejemplo una tienda de ropa online, publicar el sitio compilado de la tienda en dailywear-shop.weegloo.app constituye un Web Hosting.

El orden para subirlo es el siguiente. Primero se empaqueta el resultado de la compilación en ZIP o tar.gz y se sube mediante la Upload API para obtener un Upload. Después se crea un Web Hosting con POST /web-hostings referenciando ese Upload. Cuando el sistema procesa los archivos subidos y sys.state pasa a COMPLETED, se puede acceder al sitio a través de url. En la CMA, Web Hosting es un recurso subordinado del Space y su ruta se basa en /spaces/{spaceId}/web-hostings.

Estructura del recurso

A continuación se muestra la respuesta de consulta individual del Web Hosting "Sitio de la tienda DailyWear" ya procesado. Junto con sys (propiedades del sistema), tiene propiedades de cuerpo (name, description, isSpa, subdomain, url).

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7PWeb01Examp",
    "type": "WebHosting",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-18T11:40:00.000Z",
    "updatedAt": "2026-06-18T11:40:05.000Z",
    "state": "COMPLETED",
    "totalFileSize": 245786,
    "version": 3
  },
  "name": "Sitio de la tienda DailyWear",
  "description": "Sitio estático de la tienda de ropa y accesorios",
  "isSpa": true,
  "subdomain": "dailywear-shop",
  "url": "https://dailywear-shop.weegloo.app"
}

Claves principales:

• subdomain: el subdominio en el que se servirá el sitio. En el ejemplo anterior es dailywear-shop, y la dirección final será dailywear-shop.weegloo.app.
• url: la dirección del sitio a la que se puede acceder una vez finalizado el procesamiento.
• isSpa: indica si es una aplicación de página única (SPA). Si es true, todas las solicitudes de ruta se redirigen a index.html.
• state: el estado de procesamiento del despliegue de los archivos subidos. Se explica más abajo en Propiedades del sistema (sys).

Propiedades del sistema (sys)

Todo Web Hosting incluye las propiedades del sistema comunes en el objeto sys. space, createdBy y updatedBy se incluyen con la forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

state indica la fase de procesamiento del despliegue de los archivos subidos. No es el estado de publicación de un Content; Web Hosting no tiene el concepto de publicación ni de archivado. Cuando los archivos se procesan y el estado pasa a COMPLETED, se accede al sitio a través de url.

Propiedades del cuerpo

Las propiedades del cuerpo de Web Hosting son las siguientes.

Comprobación del subdominio

Antes de crear un Web Hosting se puede comprobar si el subdominio que se quiere usar está disponible. Basta con pasar el subdominio a comprobar como parámetro de consulta subdomain en GET /web-hostings/availability?subdomain=....

La respuesta tiene la siguiente forma; si available es true, ese subdominio se puede usar.

{ "subdomain": "dailywear-shop", "available": true }

Dominio personalizado

En lugar de la dirección por defecto {subdomain}.weegloo.app, se puede vincular a un Web Hosting un dominio propio. El estado del dominio vinculado se representa con el objeto customDomain, con la forma { id, domain, dns, cert }. dns y cert son, respectivamente, el estado de la verificación de propiedad del dominio (DNS) y el de la emisión del certificado (cert), y ambos tienen la forma { status, txtName, txtContent }. txtName y txtContent son el nombre y el valor del registro DNS TXT que hay que dar de alta en el lado del dominio.

{
  "id": 1024,
  "domain": "shop.dailywear.example",
  "dns": {
    "status": "PENDING",
    "txtName": "_weegloo.shop.dailywear.example",
    "txtContent": "weegloo-verify=3trmXRM3RqbgSnifyg7PWebVerifyEx"
  },
  "cert": {
    "status": "PENDING",
    "txtName": "_acme-challenge.shop.dailywear.example",
    "txtContent": "acme-verify=3trmXRM3RqbgSnifyg7PWebCertEx"
  }
}

Tras dar de alta el registro TXT en el lado del dominio, se activa la verificación con PUT /web-hostings/{webHostingId}/custom-domain/status/verify y se consulta el estado actual con GET /web-hostings/{webHostingId}/custom-domain/status. Cuando finaliza la verificación, dns.status y cert.status pasan a VERIFIED. Si se llama a la consulta de estado en un Web Hosting que no tiene un dominio personalizado vinculado, responde con WGL404001.

API

La URL base de todos los endpoints siguientes es https://cma.weegloo.com/v1, y se requiere un token Bearer que autentique en la CMA en la cabecera Authorization. Las modificaciones y modificaciones parciales deben enviar también la cabecera X-Weegloo-Version (el sys.version del recurso actual) para el control de concurrencia optimista. Las solicitudes de creación y eliminación no llevan esta cabecera.

Documentos relacionados

• Upload API: la solicitud para subir el ZIP de archivos estáticos y obtener el Upload que se usa al crear un Web Hosting.
• Space: el Space al que pertenece el Web Hosting.