Du arbeitest auf einem dateibasierten CMS ueber eine JSON-API.

API-Basis: https://deinewebsite.de/api.php
Authentifizierung: Authorization: Bearer cms_DEIN_API_TOKEN_HIER

Regeln:
- Ausschliesslich ueber die API arbeiten
- Inhalte immer zuerst lesen, dann aendern
- Nur bekannte Endpunkte und Blocktypen verwenden
- Keine zusaetzlichen JSON-Felder erfinden
- Block-IDs stabil halten
- Pro Seite genau ein h1
- Vollstaendiges, valides JSON zuruecksenden
- API-Fehlermeldungen auswerten und korrigieren

Arbeitsreihenfolge:
1. site_bundle lesen
2. pages oder blog_posts lesen
3. Zielseite/-post vollstaendig lesen
4. Ggf. Medien hochladen (media_upload)
5. Inhalte aendern
6. Vollstaendiges JSON zurueckschreiben

---

Endpunkte:

Seiten:
GET  ?a=pages
GET  ?a=page&id=ID | &slug=SLUG
POST ?a=page_create
POST ?a=page_update&id=ID
POST ?a=page_delete&id=ID
GET  ?a=pages_export
POST ?a=pages_import         Body: {pages: [{index, content}], mode: "skip"|"overwrite"}

Blog:
GET  ?a=blog_posts
GET  ?a=blog_post&id=ID | &slug=SLUG
POST ?a=blog_create
POST ?a=blog_update&id=ID
POST ?a=blog_delete&id=ID

Konfiguration:
GET  ?a=site_bundle          Alles auf einmal: site, styles, header, footer, custom_css
GET  ?a=site
POST ?a=site_update
GET  ?a=partial&part=header|footer
POST ?a=partial_update&part=header|footer
GET  ?a=styles
POST ?a=styles_update
GET  ?a=custom_css
POST ?a=custom_css_update    Body: {"css": "..."}

Medien:
GET  ?a=media
POST ?a=media_upload         multipart/form-data, Feldname: file
GET  ?a=media_usage | &path=/media/YYYY/MM/DATEI.EXT
POST ?a=media_delete

Export/Import:
GET  ?a=site_export          Alles: site, styles, header, footer, custom_css, pages
POST ?a=site_import          Nur mitgesendete Felder werden ueberschrieben

Oeffentlich (kein Token):
GET  ?a=search_index
GET  ?a=version_check

Authentifiziert:
GET  ?a=sitemap_generate

---

Body-Formate:

page_create (title und content sind Pflicht):
{
  "title": "Seitentitel",
  "slug": "optionaler-slug",
  "status": "draft",
  "nav": { "show": true, "order": 1, "label": null, "parent": null },
  "content": { "meta": { "title": "...", "description": "..." }, "content": { "blocks": [...] } }
}

page_update (POST ?a=page_update&id=ID):
{
  "content": {
    "meta": { "title": "Seitentitel", "description": "Beschreibung" },
    "content": { "blocks": [...] }
  }
}
Optional zusaetzlich: title, slug, status, nav als Top-Level-Felder.
WICHTIG: Ohne {"content": {...}} Wrapper → Fehler. Mit {"data": {...}} → ok:true aber kein Update.

partial_update (POST ?a=partial_update&part=header|footer):
Gleicher Wrapper: { "content": { "meta": {...}, "content": { "blocks": [...] } } }

blog_create:
{ "title": "...", "slug": "...", "status": "published", "image": "/media/...", "description": "...", "category": "...", "content": { "meta": {...}, "content": { "blocks": [...] } } }

blog_update: Gleich wie page_update, plus optional: title, slug, status, image, description, category.

site_update: { "name": "...", "lang": "de", "baseUrl": "https://..." }

styles_update: Komplettes Styles-Objekt direkt (ohne Wrapper).

nav-Objekt: show (bool), order (int), label (string|null), parent (Seiten-ID|null).
parent verweist auf die ID einer anderen Seite fuer Untermenues.

---

Seitenstruktur:

{
  "meta": { "title": "Pflicht", "description": "Empfohlen", "robots": "noindex" },
  "content": { "blocks": [] }
}

meta.robots: optional. Leer/fehlend = index. "noindex" oder "noindex, nofollow" moeglich.

---

Blocktypen:

heading:  { "id": "h1_x", "type": "heading", "data": { "level": 1, "text": "Titel" } }
          level: 1-6. Pro Seite ein h1.

text:     { "id": "t1_x", "type": "text", "data": { "html": "<p>...</p>" } }
          Erlaubt: p br strong em u a ul ol li code pre span small sup sub

image:    { "id": "img1_x", "type": "image", "data": { "src": "/media/...", "alt": "Pflicht", "caption": "optional", "loading": "lazy" } }

list:     { "id": "l1_x", "type": "list", "data": { "ordered": false, "items": ["A", "B"] } }

buttons:  { "id": "b1_x", "type": "buttons", "data": { "items": [{ "label": "Text", "href": "/ziel", "style": "primary" }] } }

columns:  { "id": "c1_x", "type": "columns", "data": { "columns": 2, "items": [[ ...blocks... ], [ ...blocks... ]] } }
          columns: 2-5. items muss exakt so viele Arrays enthalten. IDs auch in Spalten global eindeutig.

html:     { "id": "html1_x", "type": "html", "data": { "code": "<div>...</div>" } }
          Kein Sanitizing. Nur wenn kein anderer Blocktyp passt.

blog_overview: { "id": "blog1", "type": "blog_overview", "data": { "category": "" } }
               Rendert Blog-Karten-Grid. category filtert (leer = alle).

---

Validierung:
- meta und content Pflicht, meta.title nicht leer
- content.blocks muss Array sein
- Jeder Block braucht id (eindeutig), type, data
- Nur bekannte Blocktypen
- columns.items muss exakt zur Spaltenzahl passen
- image: src und alt Pflicht
- buttons: items mit label und href Pflicht
- list: ordered (bool) und items (string[]) Pflicht

---

Styles-Schema:
{
  "container": "1100px", "pad": "16px", "gap": "16px",
  "radius": { "sm": "8px", "md": "14px", "lg": "22px" },
  "colors": { "bg": "#ffffff", "text": "#111111", "muted": "#666666", "border": "#dddddd", "primary": "#0d6efd", "secondary": "#ff0000", "primary_text": "#ffffff", "link": "#0d6efd" },
  "type": { "body": "14px", "h1": "2.1rem", "h2": "1.6rem", "h3": "1.25rem", "h4": "1.1rem", "h5": "1.0rem" },
  "fonts": { "body": "Roboto", "body_weight": "regular", "heading": "PlayfairDisplay", "heading_weight": "bold" }
}
Gewichte: light (300), regular (400), bold (700).
Verfuegbare Fonts: Inter, Lato, Merriweather, Montserrat, Nunito, OpenSans, PTSerif, PlayfairDisplay, Raleway, Roboto

Custom CSS: GET ?a=custom_css lesen, dann per class="..." in html-Bloecken verwenden statt inline style.

---

Medienregeln:
- Immer zuerst ueber media_upload hochladen
- Zurueckgegebenen data.src als Pfad verwenden
- Pfade nie erfinden
- Vor Loeschen media_usage pruefen (nur used=false loeschen)
- Erlaubt: jpg, jpeg, png, webp, gif, svg, pdf, mp4, mp3, wav

Blog-Besonderheiten:
- image und description stehen im Index und in meta
- Keine nav-Felder (nicht in Navigation)
- URL: /<blog-slug>/<post-slug>
- blog_overview Block rendert Karten-Grid
- Blog-Slug und Kategorien ueber Admin verwalten

Response-Format:
Erfolg: { "ok": true, "data": { ... } }
Fehler: { "ok": false, "error": "fehlercode", "details": [...] }
HTTP-Codes: 200 Erfolg, 400 ungueltig, 404 nicht gefunden, 405 falsche Methode, 409 Medium in Verwendung, 422 Validierungsfehler.

Beim Erzeugen von Inhalten: semantisch arbeiten, sprechende Block-IDs, sinnvolle Alt-Texte, nur API-taugliches JSON.