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:
- Nur statische Dateien. Kein PHP, kein Node-/Python-Server, keine Datenbank.
- Der API-Key ist geheim. Nur im Terminal bzw. als Umgebungsvariable FABHOST_API_KEY verwenden. Niemals in HTML/JS/Konfigurationsdateien der Webseite schreiben – öffentlich hochgeladene Keys werden automatisch widerrufen.
- Formulare brauchen KEINEN API-Key im Frontend – nur die öffentliche Formular-ID.
- Formular-Einsendungen sind für KIs/API/MCP nicht lesbar (DSGVO). Der Kunde sieht sie nur im Dashboard und per E-Mail.
- Fehler kommen immer als {"error": {"code", "message", "hint"}}. Der "hint" sagt, wie man den Fehler behebt.
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": []
}
- "warnings" blockieren den Deploy nicht. Behebe sie trotzdem (siehe "hint") und deploye erneut.
- "status": "review" bedeutet: Die Seite wird manuell geprüft (z. B. Login-Formular mit Markennamen) und ist bis dahin nicht öffentlich.
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
- Endungen: html, htm, css, js, mjs, json, txt, xml, webmanifest, ico, png, jpg, jpeg, gif, webp, avif, svg, woff, woff2, ttf, otf, pdf, mp4, webm, mp3. Alles andere (auch Dateien ohne Endung) → Upload wird mit dem Dateinamen abgelehnt.
- Versteckte Dateien/Ordner (.env, .git, .htaccess …) und __MACOSX werden übersprungen. Ausnahme: .well-known/
- Max. 50 MB ZIP, 200 MB entpackt, 2000 Dateien, Ordnertiefe 15.
- Keine Symlinks. Enthält das ZIP nur einen einzelnen Ordner (z. B. dist/), wird dessen Inhalt verwendet.
- Hübsche URLs: /kontakt liefert kontakt.html. Eigene Fehlerseite: 404.html im Hauptordner.
- Rate-Limits pro Key: 30 Deploys/Stunde, 300 Requests/Minute.
API-Referenz
Basis: https://fabulous-hosting.de/api/v1 · Header: Authorization: Bearer <key> · {site} = id oder slug
| Methode | Pfad | Scope | Zweck |
|---|---|---|---|
| POST | /sites | sites:deploy | Seite anlegen {"name"} |
| GET | /sites | sites:read | Seiten auflisten |
| GET | /sites/{site} | sites:read | Eine Seite |
| POST | /sites/{site}/deploy | sites:deploy | ZIP hochladen (multipart, Feld "file") |
| GET | /sites/{site}/releases | sites:read | Letzte 5 Versionen |
| POST | /sites/{site}/rollback | sites:deploy | {"releaseId"} |
| DELETE | /sites/{site} | sites:deploy | Seite löschen |
| GET | /sites/{site}/domains | sites:read | Eigene Domains |
| POST | /sites/{site}/domains | sites:deploy | {"domain"} → DNS-Anleitung (TXT + A) |
| POST | /sites/{site}/domains/{domain}/verify | sites:deploy | TXT-Record prüfen |
| DELETE | /sites/{site}/domains/{domain} | sites:deploy | Domain entfernen |
| POST | /forms | forms:write | Formular anlegen → embedHtml |
| GET | /forms | forms:read | Formulare auflisten |
| GET | /forms/{id} | forms:read | Ein Formular |
| PUT | /forms/{id} | forms:write | Formular ändern (gleiches Format wie POST) |
| DELETE | /forms/{id} | forms:write | Formular + 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>
- Feldtypen: text, email, tel, textarea, select (mit "options"), checkbox. "name": a-z, 0-9, _.
- Settings: recipients (Standard: Konto-E-Mail; weitere Adressen müssen per Link bestätigen), successMessage, redirectUrl, allowedOrigins (zusätzliche Domains, z. B. "https://www.beispiel.de"; Seiten bei FABULOUS HOSTING sind automatisch erlaubt), retentionDays (1–365, Standard 90), includeContentInMail (Standard true), spamProtection ("altcha" = Standard, braucht forms.js; "basic" = funktioniert ohne JavaScript).
- Spam-Schutz ohne Drittanbieter: Honeypot (_hp), ALTCHA-Proof-of-Work mit Mindest-Ausfüllzeit, Rate-Limit pro IP. Kein Google reCAPTCHA nötig.
- Eigenes JavaScript statt forms.js: GET https://fabulous-hosting.de/f/{id}/challenge, Proof-of-Work lösen, dann POST https://fabulous-hosting.de/f/{id} mit JSON und Feld "_altcha" (Base64-JSON {algorithm, challenge, number, salt, signature}).
- Fehler beim Absenden: {"error": {"code": "validation_error", "fields": {"email": "…"}}}.
DSGVO-Check bei jedem Deploy (Warnungen)
| code | Problem | Lösung |
|---|---|---|
| google_fonts | Schriften von fonts.googleapis.com/gstatic | .woff2 herunterladen, per @font-face lokal einbinden |
| tracker_without_consent | Google Analytics, GTM, Meta Pixel, Hotjar, TikTok, LinkedIn ohne Consent-Tool | Tracker entfernen oder erst nach Einwilligung laden |
| embed_without_two_click | YouTube/Google Maps per iframe | Zwei-Klick-Lösung (src erst nach Klick) oder Link |
| missing_legal_links | Startseite ohne Link zu Impressum/Datenschutz | impressum.html + datenschutz.html im Footer verlinken |
| external_cdn | cdnjs, jsdelivr, unpkg … | Bibliotheken lokal mitliefern |
| api_key_exposed | API-Key in den Dateien | Key wurde widerrufen – neuen anlegen, nie ins Frontend |
Häufige Fehlercodes
- unauthorized: Key fehlt/ungültig/widerrufen. missing_scope: Key ohne nötige Berechtigung.
- forbidden_file_type: Datei mit nicht erlaubter Endung – Datei aus dem ZIP entfernen (Feld "file" nennt sie).
- unsafe_path, link_not_allowed: ZIP neu erzeugen mit "cd dist && zip -r ../site.zip .".
- missing_index_html: index.html muss im Hauptordner liegen.
- zip_too_large, unpacked_too_large, too_many_files: Medien komprimieren, nur den Build-Ordner hochladen.
- plan_limit: Tarif-Grenze (Seitenanzahl, eigene Domains).
- rate_limited: warten (Header Retry-After), nicht in einer Schleife wiederholen.