FABULOUS HOSTING

Diese Doku gibt es auch als Klartext für KIs: /llms.txt

FABULOUS HOSTING

DSGVO-konformes Hosting für statische Webseiten (Server in Deutschland) – gemacht für Seiten, die mit KI gebaut werden. Deploy per API-Key, Kontaktformulare ohne eigenen Server.

Wichtigste Regeln für KIs:

Schnellstart (curl)

export FABHOST_API_KEY=fh_live_…            # Dashboard → API-Keys
API=https://fabulous-hosting.de/api/v1

# 1. Seite anlegen (einmalig) → Antwort enthält "slug" und "url" (https://<slug>.fhosted.de)
curl -sS -X POST $API/sites -H "Authorization: Bearer $FABHOST_API_KEY" -H "Content-Type: application/json" -d '{"name": "Meine Seite"}'

# 2. Build-Ordner zippen – index.html muss im Hauptordner des ZIPs liegen
cd dist && zip -r ../site.zip . -x ".*" && cd ..

# 3. Deployen
curl -sS -X POST $API/sites/meine-seite/deploy -H "Authorization: Bearer $FABHOST_API_KEY" -F "file=@site.zip"

Antwort des Deploys:

{
  "url": "https://meine-seite.fhosted.de",
  "status": "live",
  "release": { "id": "rel_…", "files": 12, "bytes": 48213, "createdAt": "…" },
  "warnings": [ { "code": "google_fonts", "message": "…", "hint": "Lade die Schriftart herunter …", "files": ["index.html"] } ],
  "skipped": [ { "path": ".env", "reason": "versteckte Datei/versteckter Ordner" } ],
  "notes": []
}

Alternativ: CLI oder MCP

npx fabhost deploy ./dist --site meine-seite --create
claude mcp add fabhost -e FABHOST_API_KEY=fh_live_… -- npx -y fabhost-mcp

MCP-Tools: list_sites, create_site, deploy_folder, list_releases, rollback, create_form.

Erlaubte Dateien und Limits

API-Referenz

Basis: https://fabulous-hosting.de/api/v1 · Header: Authorization: Bearer <key> · {site} = id oder slug

MethodePfadScopeZweck
POST/sitessites:deploySeite anlegen {"name"}
GET/sitessites:readSeiten auflisten
GET/sites/{site}sites:readEine Seite
POST/sites/{site}/deploysites:deployZIP hochladen (multipart, Feld "file")
GET/sites/{site}/releasessites:readLetzte 5 Versionen
POST/sites/{site}/rollbacksites:deploy{"releaseId"}
DELETE/sites/{site}sites:deploySeite löschen
GET/sites/{site}/domainssites:readEigene Domains
POST/sites/{site}/domainssites:deploy{"domain"} → DNS-Anleitung (TXT + A)
POST/sites/{site}/domains/{domain}/verifysites:deployTXT-Record prüfen
DELETE/sites/{site}/domains/{domain}sites:deployDomain entfernen
POST/formsforms:writeFormular anlegen → embedHtml
GET/formsforms:readFormulare auflisten
GET/forms/{id}forms:readEin Formular
PUT/forms/{id}forms:writeFormular ändern (gleiches Format wie POST)
DELETE/forms/{id}forms:writeFormular + Einsendungen löschen

Datenschutz: Formular-Einsendungen (Nachrichten von Website-Besuchern) sind bewusst nicht per API oder MCP abrufbar. Der Kunde sieht sie nur im Dashboard und per E-Mail. Versuche nicht, sie über die API zu lesen.

Eigene Domain verbinden

curl -sS -X POST $API/sites/meine-seite/domains -H "Authorization: Bearer $FABHOST_API_KEY" -H "Content-Type: application/json" -d '{"domain": "www.beispiel.de"}'
# → TXT-Record "_fabhost-verify.www.beispiel.de" + A-Record auf 167.233.184.55 beim DNS-Anbieter anlegen, dann:
curl -sS -X POST $API/sites/meine-seite/domains/www.beispiel.de/verify -H "Authorization: Bearer $FABHOST_API_KEY"

Das HTTPS-Zertifikat wird automatisch ausgestellt, sobald der A-Record auf uns zeigt. Für beispiel.de und www.beispiel.de beide Domains hinzufügen.

Kontaktformular anlegen und einbinden

curl -sS -X POST $API/forms -H "Authorization: Bearer $FABHOST_API_KEY" -H "Content-Type: application/json" -d '{
  "name": "Kontakt",
  "siteId": "meine-seite",
  "fields": [
    {"name": "name", "label": "Name", "type": "text", "required": true},
    {"name": "email", "label": "E-Mail", "type": "email", "required": true},
    {"name": "thema", "label": "Thema", "type": "select", "options": ["Angebot", "Frage"]},
    {"name": "nachricht", "label": "Nachricht", "type": "textarea", "required": true},
    {"name": "datenschutz", "label": "Ich habe die Datenschutzerklärung gelesen und stimme zu.", "type": "checkbox", "required": true}
  ],
  "settings": { "successMessage": "Danke! Wir melden uns.", "retentionDays": 90 }
}'

Die Antwort enthält "embedHtml" – diesen Code unverändert in die Seite einfügen (Styling per CSS ist erlaubt) und neu deployen:

<form action="https://fabulous-hosting.de/f/frm_…" method="POST" accept-charset="UTF-8" data-fabhost-form>
  … Felder …
  <div style="position:absolute;left:-10000px" aria-hidden="true"><label>Dieses Feld bitte leer lassen <input name="_hp" tabindex="-1" autocomplete="off"></label></div>
  <p><button type="submit">Absenden</button></p>
  <p data-fabhost-status role="status" aria-live="polite"></p>
</form>
<script src="https://fabulous-hosting.de/embed/forms.js" defer></script>

DSGVO-Check bei jedem Deploy (Warnungen)

codeProblemLösung
google_fontsSchriften von fonts.googleapis.com/gstatic.woff2 herunterladen, per @font-face lokal einbinden
tracker_without_consentGoogle Analytics, GTM, Meta Pixel, Hotjar, TikTok, LinkedIn ohne Consent-ToolTracker entfernen oder erst nach Einwilligung laden
embed_without_two_clickYouTube/Google Maps per iframeZwei-Klick-Lösung (src erst nach Klick) oder Link
missing_legal_linksStartseite ohne Link zu Impressum/Datenschutzimpressum.html + datenschutz.html im Footer verlinken
external_cdncdnjs, jsdelivr, unpkg …Bibliotheken lokal mitliefern
api_key_exposedAPI-Key in den DateienKey wurde widerrufen – neuen anlegen, nie ins Frontend

Häufige Fehlercodes