Web Hosting

Web Hosting est une ressource qui met en ligne un site web statique compilé dans un Space et le diffuse à l'adresse {subdomain}.weegloo.app. Pour reprendre l'exemple d'une boutique de vêtements, héberger le site de boutique compilé sur dailywear-shop.weegloo.app constitue un Web Hosting.

La mise en ligne se déroule comme suit. Vous regroupez d'abord le résultat de la compilation dans une archive ZIP ou tar.gz, vous l'envoyez via l'API Upload et vous obtenez un Upload. Vous référencez ensuite cet Upload pour créer un Web Hosting avec POST /web-hostings. Lorsque le système a traité les fichiers envoyés et que sys.state passe à COMPLETED, le site est accessible via url. Dans la CMA, un Web Hosting est une ressource enfant d'un Space et son chemin se base sur /spaces/{spaceId}/web-hostings.

Structure de la ressource

Voici la réponse de consultation unitaire du Web Hosting « Site de la boutique DailyWear » une fois le traitement terminé. Outre sys (propriétés système), il porte des propriétés de corps (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": "Site de la boutique DailyWear",
  "description": "Site statique pour la boutique de vêtements et accessoires",
  "isSpa": true,
  "subdomain": "dailywear-shop",
  "url": "https://dailywear-shop.weegloo.app"
}

Clés principales :

• subdomain : le sous-domaine sous lequel le site est diffusé. Dans l'exemple ci-dessus, c'est dailywear-shop, ce qui donne l'adresse finale dailywear-shop.weegloo.app.
• url : l'adresse du site, accessible une fois le traitement terminé.
• isSpa : indique s'il s'agit d'une application monopage (SPA). Si true, toutes les requêtes de chemin sont dirigées vers index.html.
• state : l'état de traitement du déploiement des fichiers envoyés. Décrit ci-dessous dans Propriétés système (sys).

Propriétés système (sys)

Chaque Web Hosting porte ses propriétés système communes dans l'objet sys. space, createdBy et updatedBy adoptent la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

state représente l'étape de traitement du déploiement des fichiers envoyés. Il ne s'agit pas de l'état de publication d'un Content : un Web Hosting n'a pas de notion de publication ni d'archivage. Une fois les fichiers traités et state passé à COMPLETED, le site est accessible via url.

Propriétés du corps

Les propriétés de corps d'un Web Hosting sont les suivantes.

Vérification du sous-domaine

Avant de créer un Web Hosting, vous pouvez vérifier si le sous-domaine que vous comptez utiliser est disponible. Transmettez le sous-domaine à vérifier dans le paramètre de requête subdomain à GET /web-hostings/availability?subdomain=....

La réponse a la forme suivante : si available vaut true, le sous-domaine est utilisable.

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

Domaine personnalisé

Au lieu de l'adresse par défaut {subdomain}.weegloo.app, vous pouvez associer à un Web Hosting un domaine dont vous disposez. L'état du domaine associé est représenté par l'objet customDomain, de forme { id, domain, dns, cert }. dns et cert correspondent respectivement à l'état de la validation de propriété du domaine (DNS) et à celui de l'émission du certificat (cert), tous deux de forme { status, txtName, txtContent }. txtName et txtContent sont le nom et la valeur de l'enregistrement DNS TXT à créer côté domaine.

{
  "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"
  }
}

Après avoir créé les enregistrements TXT côté domaine, déclenchez la validation avec PUT /web-hostings/{webHostingId}/custom-domain/status/verify, et consultez l'état courant avec GET /web-hostings/{webHostingId}/custom-domain/status. Une fois la validation terminée, dns.status et cert.status passent à VERIFIED. Appeler la consultation d'état sur un Web Hosting auquel aucun domaine personnalisé n'est associé renvoie WGL404001.

API

L'URL de base de tous les endpoints ci-dessous est https://cma.weegloo.com/v1, et l'en-tête Authorization doit contenir un jeton Bearer authentifiant la CMA. Les modifications et modifications partielles doivent transmettre en plus l'en-tête X-Weegloo-Version (le sys.version courant de la ressource) pour assurer le contrôle de concurrence optimiste. Les requêtes de création et de suppression n'utilisent pas cet en-tête.

Documents associés

• API Upload : la requête qui envoie l'archive ZIP de fichiers statiques et renvoie l'Upload à utiliser pour créer un Web Hosting.
• Space : le Space auquel appartient un Web Hosting.