Web Hosting

Web Hosting ist eine Ressource, die eine erstellte statische Website in einen Space hochlädt und unter der Adresse {subdomain}.weegloo.app bereitstellt. Am Beispiel eines Bekleidungsshops: Die erstellte Shop-Website unter dailywear-shop.weegloo.app bereitzustellen, entspricht einem Web Hosting.

Der Ablauf des Hochladens ist wie folgt. Zunächst packen Sie das Build-Ergebnis als ZIP oder tar.gz und laden es über die Upload API hoch, um ein Upload zu erhalten. Dieses Upload referenzieren Sie, um mit POST /web-hostings ein Web Hosting zu erstellen. Sobald das System die hochgeladenen Dateien verarbeitet hat und sys.state auf COMPLETED steht, ist die Website über url erreichbar. In der CMA ist Web Hosting eine untergeordnete Ressource des Space, und der Pfad basiert auf /spaces/{spaceId}/web-hostings.

Ressourcenstruktur

Nachstehend sehen Sie die Antwort einer Einzelabfrage des fertig verarbeiteten Web Hosting "DailyWear Shop-Website". Neben sys (Systemattribute) enthält es Hauptattribute (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": "DailyWear Shop-Website",
  "description": "Statische Website für den Shop für Kleidung und Accessoires",
  "isSpa": true,
  "subdomain": "dailywear-shop",
  "url": "https://dailywear-shop.weegloo.app"
}

Wichtige Schlüssel:

• subdomain: Die Subdomain, unter der die Website bereitgestellt wird. Im Beispiel oben ist es dailywear-shop, die endgültige Adresse lautet dailywear-shop.weegloo.app.
• url: Die Adresse, unter der die Website nach Abschluss der Verarbeitung erreichbar ist.
• isSpa: Gibt an, ob es sich um eine Single-Page-Application (SPA) handelt. Bei true werden alle Pfadanfragen an index.html weitergeleitet.
• state: Der Verarbeitungsstatus des Deployments der hochgeladenen Dateien. Wird unten unter Systemattribute (sys) erläutert.

Systemattribute (sys)

Jedes Web Hosting führt gemeinsame Systemattribute im Objekt sys. space, createdBy und updatedBy liegen in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) vor.

state gibt die Verarbeitungsphase des Deployments der hochgeladenen Dateien an. Es ist nicht der Veröffentlichungsstatus eines Content; bei Web Hosting gibt es kein Konzept von Veröffentlichung oder Archivierung. Sobald die Dateien verarbeitet sind und COMPLETED erreichen, ist die Website über url erreichbar.

Hauptattribute

Die Hauptattribute eines Web Hosting sind die folgenden.

Subdomain prüfen

Bevor Sie ein Web Hosting erstellen, können Sie prüfen, ob die gewünschte Subdomain frei ist. Übergeben Sie an GET /web-hostings/availability?subdomain=... die zu prüfende Subdomain als subdomain-Query.

Die Antwort hat die folgende Form; ist available gleich true, kann diese Subdomain verwendet werden.

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

Benutzerdefinierte Domain

Anstelle der Standardadresse {subdomain}.weegloo.app können Sie eine eigene Domain mit dem Web Hosting verbinden. Der Status der verbundenen Domain wird durch das Objekt customDomain dargestellt und hat die Form { id, domain, dns, cert }. dns und cert geben jeweils den Status der Domain-Eigentumsprüfung (DNS) und der Zertifikatsausstellung (cert) an und haben beide die Form { status, txtName, txtContent }. txtName und txtContent sind Name und Wert des DNS-TXT-Eintrags, der auf der Domain-Seite registriert werden muss.

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

Nachdem Sie den TXT-Eintrag auf der Domain-Seite registriert haben, lösen Sie die Prüfung mit PUT /web-hostings/{webHostingId}/custom-domain/status/verify aus und fragen den aktuellen Status mit GET /web-hostings/{webHostingId}/custom-domain/status ab. Nach Abschluss der Prüfung wechseln dns.status und cert.status auf VERIFIED. Wird die Statusabfrage für ein Web Hosting aufgerufen, mit dem keine benutzerdefinierte Domain verbunden ist, antwortet die API mit WGL404001.

API

Die Basis-URL aller folgenden Endpunkte ist https://cma.weegloo.com/v1, und im Header Authorization wird ein Bearer-Token zur Authentifizierung gegenüber der CMA benötigt. Für die Aktualisierung und Teilaktualisierung muss zur optimistischen Nebenläufigkeitskontrolle der Header X-Weegloo-Version (die sys.version der aktuellen Ressource) mitgesendet werden. Bei Erstellungs- und Löschanfragen entfällt dieser Header.

Verwandte Dokumente

• Upload API: Die Anfrage, mit der ein statisches Datei-ZIP hochgeladen und das Upload für die Erstellung eines Web Hosting abgerufen wird.
• Space: Der Space, zu dem das Web Hosting gehört.