API Reference | CODEFLUSS

Die CODEFLUSS API ermöglicht Ihnen, Projekte, Seiten und Design-Elemente programmatisch zu verwalten. Die API folgt REST-Prinzipien und verwendet JSON für Request- und Response-Bodies.

API-Version

Aktuelle Version: v1 (0.0.1-alpha)
Stand: 2026-01-23

Alle API-Endpunkte sind unter dem Präfix /api/v1/ verfügbar.

Base URL

Alle API-Anfragen werden an folgende Base URL gesendet:

https://api.codefluss.com/v1

Für Staging-Umgebungen verwenden Sie https://api.codefluss.dev/v1.

Schnellstart

1. API-Key erstellen

Navigieren Sie zu Einstellungen → API Keys in Ihrem CODEFLUSS Dashboard, um einen neuen API-Key zu erstellen.

2. Erste Anfrage

curl -X GET "https://api.codefluss.com/v1/projects?organizationId=org_xyz789" \
  -H "Authorization: Bearer cf_live_abc123..." \
  -H "Content-Type: application/json"

3. Response

{
  "success": true,
  "data": [
    {
      "id": "proj_abc123",
      "name": "Meine Website",
      "type": "website",
      "status": "active"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalItems": 1
  }
}

Authentifizierung

Die API verwendet Bearer Token Authentication:

Authorization: Bearer your_api_key_here

Siehe Authentifizierung für Details.

Response Format

Alle Responses folgen diesem Format:

{
  "success": true,
  "data": { /* Daten */ },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-23T12:00:00Z"
  }
}

Fehlerbehandlung

Fehler werden mit HTTP-Statuscodes und strukturiertem Body zurückgegeben:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid project name",
    "details": { "field": "name" }
  }
}

Status	Bedeutung
`200`	Erfolg
`201`	Ressource erstellt
`400`	Ungültige Anfrage
`401`	Nicht authentifiziert
`403`	Keine Berechtigung
`404`	Nicht gefunden
`429`	Rate Limit
`500`	Serverfehler

Siehe Fehlerbehandlung für alle Fehlercodes.

Verfügbare Kategorien

Grundlagen

Authentifizierung – API-Keys und Berechtigungen
Rate Limits – Anfragelimits
Fehlerbehandlung – Fehlercodes

Kern-Ressourcen

Projekte – Projektverwaltung
Websites – Website-Konfiguration
Seiten – Seitenverwaltung
Sections – Section-Bausteine
Medien – Datei-Upload

Content

Blog-Einträge – Blog-Artikel
Blog-Tags – Kategorisierung
Editor – Editor-Konfiguration

Design

Design System – Übersicht
Farben – Farbpalette
Typografie – Schriften
Abstände – Spacing
Effekte – Animationen

AI Studio

AI-Analyse – Inhaltsanalyse
Bildgenerierung – KI-Bilder
Code-Generierung – KI-Code

Account

Kontoverwaltung – Benutzerkonto
Einstellungen – Profil & Sicherheit
Organisationen – Teams

Integration

Zugangsdaten – API-Schlüssel
Feature Flags – Feature-Steuerung
Webhooks – Event-Benachrichtigungen

Rechtliches

Cookie-Einstellungen – DSGVO-Banner
Impressum – Pflichtangaben
Datenschutz – Datenschutzerklärung

Öffentliche API

Öffentliche Seiten – Ohne Auth abrufbar