Editor
Die Editor API ermöglicht die Konfiguration von Editor-spezifischen Einstellungen wie Sprachkonfigurationen und Website-Optionen.
Endpunkte
| Methode | Endpunkt | Beschreibung |
|---|
GET | /api/v1/editor/languages-settings | Spracheinstellungen abrufen |
POST | /api/v1/editor/languages-settings | Spracheinstellungen erstellen |
GET | /api/v1/editor/project-settings | Projekteinstellungen abrufen |
PUT | /api/v1/editor/project-settings | Projekteinstellungen aktualisieren |
GET | /api/v1/editor/website-configuration | Website-Konfiguration abrufen |
PUT | /api/v1/editor/website-configuration | Website-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
| Strategie | Beispiel | Beschreibung |
|---|
prefix | /de/about | Sprachcode als URL-Präfix |
subdomain | de.example.com/about | Sprache als Subdomain |
query | /about?lang=de | Sprache 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"
}
}
| Stil | Beschreibung |
|---|
fixed | Header bleibt beim Scrollen fixiert |
sticky | Header klebt beim Scrollen oben |
static | Header scrollt mit der Seite |
overlay | Header überlagert den Content |
Unterstützte Plattformen für socialLinks:
twitter
linkedin
facebook
instagram
youtube
github
xing
Fehler
| Code | Beschreibung |
|---|
400 | Ungültige Konfigurationswerte |
401 | Nicht authentifiziert |
403 | Keine Berechtigung |
404 | Projekt/Website nicht gefunden |
Nächste Schritte