Einstellungen | API Reference | CODEFLUSS

Blog-Einstellungen

Die Blog Settings API ermöglicht die Konfiguration von projektweiten Blog-Einstellungen.

Endpunkte

Methode	Endpunkt	Beschreibung
`GET`	`/api/v1/blog/settings/{projectId}`	Einstellungen abrufen
`PUT`	`/api/v1/blog/settings/{projectId}`	Einstellungen aktualisieren

Das BlogSettings-Objekt

{
  "id": "settings_abc123",
  "projectId": "proj_xyz789",
  "defaultAuthorId": "user_def456",
  "defaultBlogDetailTemplateId": "tmpl_ghi789",
  "defaultBlogListTemplateId": "tmpl_jkl012",
  "postsPerPage": 10,
  "enableComments": false,
  "enableRss": true,
  "rssTitle": "Unser Blog",
  "rssDescription": "Aktuelle Nachrichten und Artikel",
  "defaultLanguage": "de",
  "supportedLanguages": ["de", "en"],
  "seo": {
    "indexBlogPages": true,
    "generateSitemap": true,
    "canonicalBase": "https://www.meine-firma.de/blog"
  },
  "social": {
    "enableSharing": true,
    "platforms": ["twitter", "linkedin", "facebook"]
  },
  "createdAt": "2026-01-10T08:00:00Z",
  "updatedAt": "2026-01-22T12:00:00Z"
}

Attribute

Attribut	Typ	Beschreibung
`id`	string	Eindeutige Einstellungs-ID
`projectId`	string	Zugehöriges Blog-Projekt
`defaultAuthorId`	string	Standard-Autor für neue Einträge
`defaultBlogDetailTemplateId`	string	Standard-Template für Artikelseiten
`defaultBlogListTemplateId`	string	Standard-Template für Listenansicht
`postsPerPage`	integer	Einträge pro Seite (Pagination)
`enableComments`	boolean	Kommentare aktivieren
`enableRss`	boolean	RSS-Feed aktivieren
`rssTitle`	string	Titel des RSS-Feeds
`rssDescription`	string	Beschreibung des RSS-Feeds
`defaultLanguage`	string	Standardsprache
`supportedLanguages`	array	Unterstützte Sprachen
`seo`	object	SEO-Konfiguration
`social`	object	Social-Sharing-Konfiguration
`createdAt`	string	Erstellungszeitpunkt
`updatedAt`	string	Letzte Aktualisierung

Einstellungen abrufen

GET /api/v1/blog/settings/{projectId}

Beispiel-Request

curl -X GET "https://api.codefluss.com/v1/blog/settings/proj_xyz789" \
  -H "Authorization: Bearer cf_live_abc123..."

Beispiel-Response

{
  "success": true,
  "data": {
    "projectId": "proj_xyz789",
    "defaultAuthorId": "user_def456",
    "postsPerPage": 10,
    "enableComments": false,
    "enableRss": true,
    "defaultLanguage": "de",
    "supportedLanguages": ["de", "en"],
    "seo": {
      "indexBlogPages": true,
      "generateSitemap": true
    }
  }
}

Einstellungen aktualisieren

PUT /api/v1/blog/settings/{projectId}

Request-Body

Nur die zu ändernden Felder angeben:

{
  "postsPerPage": 12,
  "enableRss": true,
  "rssTitle": "Unser Firmenblog",
  "rssDescription": "Aktuelle News und Insights",
  "seo": {
    "indexBlogPages": true,
    "generateSitemap": true,
    "canonicalBase": "https://www.meine-firma.de/blog"
  }
}

Aktualisierbare Felder

Feld	Typ	Beschreibung
`defaultAuthorId`	string	Standard-Autor-ID
`defaultBlogDetailTemplateId`	string	Standard-Detail-Template
`defaultBlogListTemplateId`	string	Standard-Listen-Template
`postsPerPage`	integer	Einträge pro Seite (1-50)
`enableComments`	boolean	Kommentare aktivieren
`enableRss`	boolean	RSS-Feed aktivieren
`rssTitle`	string	RSS-Feed-Titel
`rssDescription`	string	RSS-Feed-Beschreibung
`defaultLanguage`	string	Standardsprache
`supportedLanguages`	array	Unterstützte Sprachen
`seo`	object	SEO-Einstellungen
`social`	object	Social-Sharing-Einstellungen

Response

{
  "success": true,
  "data": {
    "projectId": "proj_xyz789",
    "postsPerPage": 12,
    "enableRss": true,
    "rssTitle": "Unser Firmenblog",
    "updatedAt": "2026-01-23T10:00:00Z"
  }
}

SEO-Einstellungen

Das seo-Objekt unterstützt folgende Optionen:

{
  "seo": {
    "indexBlogPages": true,
    "generateSitemap": true,
    "canonicalBase": "https://www.meine-firma.de/blog",
    "defaultOgImage": "med_abc123",
    "structuredData": {
      "organization": "Meine Firma GmbH",
      "logo": "https://www.meine-firma.de/logo.png"
    }
  }
}

Feld	Typ	Beschreibung
`indexBlogPages`	boolean	Seiten von Suchmaschinen indexieren
`generateSitemap`	boolean	Blog-URLs in Sitemap aufnehmen
`canonicalBase`	string	Basis-URL für Canonical-Tags
`defaultOgImage`	string	Standard-OG-Bild (Media-ID)
`structuredData`	object	Schema.org-Daten

{
  "social": {
    "enableSharing": true,
    "platforms": ["twitter", "linkedin", "facebook", "whatsapp", "email"],
    "defaultHashtags": ["MeineFirma", "Blog"],
    "twitterHandle": "@meinefirma"
  }
}

Feld	Typ	Beschreibung
`enableSharing`	boolean	Sharing-Buttons anzeigen
`platforms`	array	Verfügbare Plattformen
`defaultHashtags`	array	Standard-Hashtags für Twitter
`twitterHandle`	string	Twitter-Handle für via-Mention

RSS-Feed

Wenn enableRss: true, ist der RSS-Feed verfügbar unter:

https://www.meine-website.de/blog/rss.xml

Der Feed enthält:

Titel, Beschreibung und Autor
Die letzten 20 veröffentlichten Einträge
Vollständiger Inhalt oder Excerpt (konfigurierbar)

Fehler

Code	Beschreibung
`400`	Ungültige Konfigurationswerte
`401`	Nicht authentifiziert
`403`	Keine Berechtigung
`404`	Projekt nicht gefunden

Nächste Schritte

Blog-Einträge – Einträge erstellen
Blog-Tags – Tags verwalten