Editor

Editor

Die Editor API ermöglicht die Konfiguration von Editor-spezifischen Einstellungen wie Sprachkonfigurationen und Website-Optionen.

Endpunkte

MethodeEndpunktBeschreibung
GET/api/v1/editor/languages-settingsSpracheinstellungen abrufen
POST/api/v1/editor/languages-settingsSpracheinstellungen erstellen
GET/api/v1/editor/project-settingsProjekteinstellungen abrufen
PUT/api/v1/editor/project-settingsProjekteinstellungen aktualisieren
GET/api/v1/editor/website-configurationWebsite-Konfiguration abrufen
PUT/api/v1/editor/website-configurationWebsite-Konfiguration aktualisieren

Spracheinstellungen

Das LanguageSettings-Objekt

{ "id": "lang_abc123", "projectId": "proj_xyz789", "defaultLanguage": "de", "languages": [ { "code": "de", "name": "Deutsch", "enabled": true, "isDefault": true }, { "code": "en", "name": "English", "enabled": true, "isDefault": false }, { "code": "es", "name": "Español", "enabled": false, "isDefault": false } ], "fallbackBehavior": "default", "urlStrategy": "prefix", "createdAt": "2026-01-10T08:00:00Z", "updatedAt": "2026-01-22T12:00:00Z" }

Abrufen

GET /api/v1/editor/languages-settings?projectId=proj_xyz789

Erstellen/Aktualisieren

POST /api/v1/editor/languages-settings
{ "projectId": "proj_xyz789", "defaultLanguage": "de", "languages": [ { "code": "de", "name": "Deutsch", "enabled": true }, { "code": "en", "name": "English", "enabled": true } ], "urlStrategy": "prefix" }

URL-Strategien

StrategieBeispielBeschreibung
prefix/de/aboutSprachcode als URL-Präfix
subdomainde.example.com/aboutSprache als Subdomain
query/about?lang=deSprache als Query-Parameter

Projekteinstellungen

Das ProjectSettings-Objekt

{ "id": "ps_abc123", "projectId": "proj_xyz789", "editor": { "autosave": true, "autosaveInterval": 30, "showGrid": true, "snapToGrid": true, "gridSize": 8 }, "preview": { "defaultDevice": "desktop", "showDeviceFrame": true }, "publishing": { "requireApproval": false, "notifyOnPublish": true, "notificationEmails": ["team@firma.de"] } }

Abrufen

GET /api/v1/editor/project-settings?projectId=proj_xyz789

Aktualisieren

PUT /api/v1/editor/project-settings
{ "projectId": "proj_xyz789", "editor": { "autosave": true, "autosaveInterval": 60, "gridSize": 4 } }

Website-Konfiguration

Das WebsiteConfiguration-Objekt

{ "id": "wc_abc123", "websiteId": "web_xyz789", "general": { "siteName": "Meine Firma", "tagline": "Ihr Partner für digitale Lösungen", "favicon": "med_fav123", "logo": "med_logo456" }, "navigation": { "headerStyle": "fixed", "showLanguageSwitcher": true, "mobileBreakpoint": 768 }, "footer": { "showCopyright": true, "copyrightText": "© 2026 Meine Firma GmbH", "socialLinks": [ { "platform": "twitter", "url": "https://twitter.com/meinefirma" }, { "platform": "linkedin", "url": "https://linkedin.com/company/meinefirma" } ] }, "analytics": { "googleAnalyticsId": "G-XXXXXXXXXX", "cookieConsent": true }, "performance": { "lazyLoadImages": true, "preloadFonts": true, "minifyCss": true, "minifyJs": true } }

Abrufen

GET /api/v1/editor/website-configuration?websiteId=web_xyz789

Aktualisieren

PUT /api/v1/editor/website-configuration
{ "websiteId": "web_xyz789", "general": { "siteName": "Neuer Firmenname", "tagline": "Neue Tagline" }, "analytics": { "googleAnalyticsId": "G-YYYYYYYYYY" } }

Header-Stile

StilBeschreibung
fixedHeader bleibt beim Scrollen fixiert
stickyHeader klebt beim Scrollen oben
staticHeader scrollt mit der Seite
overlayHeader überlagert den Content

Social-Plattformen

Unterstützte Plattformen für socialLinks:

  • twitter
  • linkedin
  • facebook
  • instagram
  • youtube
  • github
  • xing

Fehler

CodeBeschreibung
400Ungültige Konfigurationswerte
401Nicht authentifiziert
403Keine Berechtigung
404Projekt/Website nicht gefunden

Nächste Schritte