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, pageMetas).

{
  "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,
    "originMetas": [
      {
        "file": "index.html",
        "meta": {
          "title": "Daily Wear Store",
          "description": "Everyday clothing store"
        }
      }
    ],
    "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",
  "pageMetas": [
    {
      "file": "index.html",
      "meta": {
        "title": "DailyWear - clothes for every day",
        "description": "Everyday pieces you can wear to work and on weekends.",
        "image": "https://dailywear-shop.weegloo.app/og-cover.png"
      }
    }
  ]
}

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).
• pageMetas: los valores de las etiquetas meta sobrescritos por documento. sys.originMetas guarda los valores tal como estaban antes de sobrescribirlos. Ambos se explican en Metadatos por documento, más abajo.

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 pasa a active y cert.status pasa a ok. Si se llama a la consulta de estado en un Web Hosting que no tiene un dominio personalizado vinculado, responde con un error (consulte Errores).

Metadatos por documento

Puede sobrescribir las etiquetas meta del <head> de cada documento de un sitio que haya publicado. El título, la descripción y la imagen que aparecen en los resultados de búsqueda y en las vistas previas de enlaces de los mensajeros cambian a estos valores. La finalidad es cambiarlos con una sola petición en lugar de volver a compilar y subir los archivos.

La edición solo funciona en un Web Hosting creado al instalar una MarketApp. En cuanto reemplace los archivos mediante upload, la edición deja de ser posible y sys.originMetas se vacía con ello. Una petición que incumpla la condición se rechaza (consulte Errores).

Los valores van en el array pageMetas, y cada entrada apunta a un documento.

sys.originMetas tiene la misma forma y guarda los valores que los documentos traían antes de sobrescribirlos. Para revertir, envíe de nuevo esos valores.

Ranuras

Las claves de meta se llaman ranuras. Una ranura cambia varias etiquetas a la vez.

Si una etiqueta no está en el documento, se crea y se inserta. Cinco son la excepción: twitter:title, twitter:description, twitter:image, link[rel="shortcut icon"] y link[rel=apple-touch-icon] solo cambian cuando el documento ya las tiene, y no se crean cuando no las tiene.

Qué hace cada valor

El resultado depende de la forma del valor que envíe.

Preste especial atención a las dos últimas filas. El servidor fusiona lo enviado por documento y por ranura. Por eso omitir una entrada del array no borra un ajuste; para borrarlo debe indicar una cadena vacía en esa ranura.

Una cadena vacía elimina la etiqueta en lugar de restaurar el estado original. Una etiqueta que el documento traía desaparece con ella. Para restaurar el valor original, envíe el valor que sigue guardado en sys.originMetas.

El siguiente cuerpo de petición cambia solo el título de index.html y elimina su etiqueta de descripción.

{
  "pageMetas": [
    {
      "file": "index.html",
      "meta": {
        "title": "DailyWear - ropa para cada día",
        "description": ""
      }
    }
  ]
}

Al cambiar pageMetas arranca el procesamiento que aplica esos valores a los documentos reales. sys.state vuelve a PENDING y después regresa a COMPLETED, y entretanto las modificaciones y los borrados se rechazan.

Errores

Códigos que se encuentran al trabajar con Web Hosting. Para los códigos comunes a todos los recursos, consulte Errores comunes.

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.