# 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) ```bash 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://.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: ```json { "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 ```bash 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 · {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 ```bash 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 ```bash 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: ```html
… Felder …

``` - 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.