Öffentliche Seiten | API Reference | CODEFLUSS

Öffentliche API

Die Public API stellt schreibgeschützte Endpunkte bereit, die ohne Authentifizierung für die Darstellung veröffentlichter Inhalte genutzt werden können.

Endpunkte

Methode	Endpunkt	Beschreibung
`GET`	`/api/v1/public/page`	Öffentliche Seite abrufen
`GET`	`/api/v1/public/website`	Öffentliche Website-Daten

Öffentliche Seite

Ruft den veröffentlichten Inhalt einer Seite ab.

GET /api/v1/public/page?domain=example.codefluss.app&path=/about

Query-Parameter

Parameter	Typ	Beschreibung
`domain`	string	Domain oder Subdomain
`path`	string	Seitenpfad
`locale`	string	Sprache (optional)

Response

{
  "success": true,
  "data": {
    "id": "page_abc123",
    "title": "Über uns",
    "path": "/about",
    "seo": {
      "title": "Über uns | Meine Firma",
      "description": "Erfahren Sie mehr über uns..."
    },
    "sections": [
      {
        "id": "sec_001",
        "type": "hero",
        "content": {
          "headline": "Wir sind Meine Firma",
          "subheadline": "..."
        },
        "styles": { ... }
      }
    ],
    "publishedAt": "2026-01-20T10:00:00Z"
  }
}

Öffentliche Website-Daten

Ruft die öffentlichen Konfigurationsdaten einer Website ab.

GET /api/v1/public/website?domain=example.codefluss.app

Response

{
  "success": true,
  "data": {
    "name": "Meine Firma",
    "domain": "example.codefluss.app",
    "favicon": "https://cdn.codefluss.com/...",
    "logo": "https://cdn.codefluss.com/...",
    "navigation": [
      { "title": "Start", "path": "/" },
      { "title": "Über uns", "path": "/about" },
      { "title": "Kontakt", "path": "/contact" }
    ],
    "footer": { ... },
    "seo": {
      "defaultTitle": "Meine Firma",
      "titleTemplate": "%s | Meine Firma"
    },
    "languages": ["de", "en"],
    "defaultLanguage": "de"
  }
}

Caching

Public API Responses werden mit Cache-Headern geliefert:

Cache-Control: public, max-age=60, stale-while-revalidate=300

Rate Limits

Endpunkt	Limit
`/api/v1/public/*`	1000/Minute

Fehler

Code	Beschreibung
`404`	Seite/Website nicht gefunden
`410`	Inhalt wurde zurückgezogen
`429`	Rate Limit überschritten