So veroeffentlichst du Inhalte per HTTP POST

Endpoint und Auth

Body-Formate

Wissen

Evergreen-Artikel, Leitfaeden und erklaerende Fachinhalte.

Ablauf fuer Poster

1. JSON nach der Feldtabelle fuer content_type = "wissen" bauen.
2. Optional Medien ueber Media Ingest mit denselben Strukturwerten hochladen.
3. JSON per POST /api/content-ingest mit API-Key senden.
4. Bei draft im Admin pruefen; bei publish den angegebenen Zielpfad pruefen.

Media-Mapping: Media Ingest mit content_type=wissen, derselben category_path und demselben content_slug verwenden; in Media-Feldern die url aus der Media-Ingest-Antwort einsetzen.

Feldtabelle

Kleinster valider JSON-Payload

{
    "content_type": "wissen",
    "content_slug": "espr-grundlagen",
    "content_format": "leitfaden",
    "category_path": [
        "compliance"
    ],
    "category_definitions": [
        {
            "slug": "compliance",
            "label": "Compliance"
        }
    ],
    "tags": [],
    "tag_definitions": [],
    "meta": {
        "title": "ESPR-Grundlagen fuer digitale Produktpaesse",
        "description": "Kompakter Leitfaden zu ESPR und digitalen Produktpaessen.",
        "date": "2026-06-30"
    },
    "content": {
        "headline": "ESPR-Grundlagen fuer digitale Produktpaesse",
        "intro": "Was Unternehmen jetzt ueber DPP-Daten wissen sollten.",
        "sections": [
            {
                "body": "<p>Produktdaten muessen strukturiert vorliegen.</p>"
            }
        ]
    }
}

Blog & News

Aktuelle News, Einordnungen und redaktionelle Updates.

Ablauf fuer Poster

1. JSON nach der Feldtabelle fuer content_type = "blog" bauen.
2. Optional Medien ueber Media Ingest mit denselben Strukturwerten hochladen.
3. JSON per POST /api/content-ingest mit API-Key senden.
4. Bei draft im Admin pruefen; bei publish den angegebenen Zielpfad pruefen.

Media-Mapping: Media Ingest mit content_type=blog, derselben category_path und demselben content_slug verwenden; in Media-Feldern die url aus der Media-Ingest-Antwort einsetzen.

Feldtabelle

Kleinster valider JSON-Payload

{
    "content_type": "blog",
    "content_slug": "espr-fristen-2026",
    "content_format": "news",
    "category_path": [
        "regulierung"
    ],
    "category_definitions": [
        {
            "slug": "regulierung",
            "label": "Regulierung"
        }
    ],
    "tags": [],
    "tag_definitions": [],
    "meta": {
        "title": "ESPR-Fristen 2026: Was Unternehmen klaeren sollten",
        "description": "Einordnung zu ESPR-Fristen und Datenvorbereitung.",
        "date": "2026-06-30"
    },
    "content": {
        "headline": "ESPR-Fristen 2026",
        "body": "<p>Die naechste Projektphase sollte Datenquellen und Verantwortlichkeiten klaeren.</p>"
    }
}

Whitepaper

Whitepaper-Seiten fuer Downloads und fachliche Deep Dives.

Ablauf fuer Poster

1. JSON nach der Feldtabelle fuer content_type = "whitepaper" bauen.
2. Optional Medien ueber Media Ingest mit denselben Strukturwerten hochladen.
3. JSON per POST /api/content-ingest mit API-Key senden.
4. Bei draft im Admin pruefen; bei publish den angegebenen Zielpfad pruefen.

Media-Mapping: Media Ingest mit content_type=whitepaper, derselben category_path und demselben content_slug verwenden; in Media-Feldern die url aus der Media-Ingest-Antwort einsetzen.

Feldtabelle

Kleinster valider JSON-Payload

{
    "content_type": "whitepaper",
    "content_slug": "dpp-roadmap-retail",
    "content_format": "whitepaper",
    "category_path": [
        "retail"
    ],
    "category_definitions": [
        {
            "slug": "retail",
            "label": "Retail"
        }
    ],
    "tags": [],
    "tag_definitions": [],
    "meta": {
        "title": "DPP-Roadmap fuer Retail | Whitepaper",
        "description": "Whitepaper zur Planung von digitalen Produktpaessen.",
        "date": "2026-06-30"
    },
    "content": {
        "headline": "DPP-Roadmap fuer Retail",
        "intro": "So planen Handelsunternehmen DPP und Smart Labels.",
        "sections": [
            {
                "body": "<p>Das Whitepaper erklaert Projektphasen und Datenverantwortung.</p>"
            }
        ]
    }
}

Produkte

Produktseiten fuer Smart Labels, QR-Etiketten, NFC und RFID.

Ablauf fuer Poster

1. JSON nach der Feldtabelle fuer content_type = "produkte" bauen.
2. Optional Medien ueber Media Ingest mit denselben Strukturwerten hochladen.
3. JSON per POST /api/content-ingest mit API-Key senden.
4. Bei draft im Admin pruefen; bei publish den angegebenen Zielpfad pruefen.

Media-Mapping: Media Ingest mit content_type=produkte, derselben category_path und demselben content_slug verwenden; in Media-Feldern die url aus der Media-Ingest-Antwort einsetzen.

Feldtabelle

Kleinster valider JSON-Payload

{
    "content_type": "produkte",
    "content_slug": "qr-folie-robust",
    "content_format": "produktinfo",
    "category_path": [
        "qr-etiketten"
    ],
    "category_definitions": [
        {
            "slug": "qr-etiketten",
            "label": "QR-Etiketten"
        }
    ],
    "tags": [],
    "tag_definitions": [],
    "meta": {
        "title": "Robustes QR-Folienetikett | DPP Labels",
        "description": "Widerstandsfaehiges QR-Folienetikett fuer Produktinformationen."
    },
    "content": {
        "headline": "Robustes QR-Folienetikett",
        "intro": "Ein strapazierfaehiges QR-Etikett fuer Produkte.",
        "features": [
            "Robuste Folienbasis"
        ],
        "sections": [
            {
                "body": "<p>Das Etikett eignet sich fuer Verpackungen und Produktinformationen.</p>"
            }
        ]
    }
}

Anwendungen

Use Cases mit Herausforderung, Loesung und Nutzenargumenten.

Ablauf fuer Poster

1. JSON nach der Feldtabelle fuer content_type = "anwendungen" bauen.
2. Optional Medien ueber Media Ingest mit denselben Strukturwerten hochladen.
3. JSON per POST /api/content-ingest mit API-Key senden.
4. Bei draft im Admin pruefen; bei publish den angegebenen Zielpfad pruefen.

Media-Mapping: Media Ingest mit content_type=anwendungen, derselben category_path und demselben content_slug verwenden; in Media-Feldern die url aus der Media-Ingest-Antwort einsetzen.

Feldtabelle

Kleinster valider JSON-Payload

{
    "content_type": "anwendungen",
    "content_slug": "dpp-kosmetik-smart-labels",
    "content_format": "usecase",
    "category_path": [
        "digitaler-produktpass"
    ],
    "category_definitions": [
        {
            "slug": "digitaler-produktpass",
            "label": "Digitaler Produktpass"
        }
    ],
    "tags": [],
    "tag_definitions": [],
    "meta": {
        "title": "Digitaler Produktpass fuer Kosmetik",
        "description": "Use Case fuer Smart Labels in der Kosmetikbranche."
    },
    "content": {
        "headline": "Digitaler Produktpass fuer Kosmetik",
        "intro": "Smart Labels machen Produktinformationen direkt erreichbar.",
        "challenge": "<p>Informationen muessen aktuell und produktnah sein.</p>",
        "solution": "<p>QR oder NFC verbinden Produkt und digitale Daten.</p>",
        "benefits": [
            "Mehr Informationsflaeche"
        ]
    }
}

Branchen

Branchenseiten mit Anforderungen, Kontext und Smart-Label-Nutzen.

Ablauf fuer Poster

1. JSON nach der Feldtabelle fuer content_type = "branchen" bauen.
2. Optional Medien ueber Media Ingest mit denselben Strukturwerten hochladen.
3. JSON per POST /api/content-ingest mit API-Key senden.
4. Bei draft im Admin pruefen; bei publish den angegebenen Zielpfad pruefen.

Media-Mapping: Media Ingest mit content_type=branchen, derselben category_path und demselben content_slug verwenden; in Media-Feldern die url aus der Media-Ingest-Antwort einsetzen.

Feldtabelle

Kleinster valider JSON-Payload

{
    "content_type": "branchen",
    "content_slug": "kosmetik-personal-care",
    "content_format": "artikel",
    "category_path": [
        "konsumgueter"
    ],
    "category_definitions": [
        {
            "slug": "konsumgueter",
            "label": "Konsumgueter"
        }
    ],
    "tags": [],
    "tag_definitions": [],
    "meta": {
        "title": "Smart Labels fuer Kosmetik und Personal Care",
        "description": "Branchenseite zu QR, NFC und digitalen Produktinformationen."
    },
    "content": {
        "headline": "Smart Labels fuer Kosmetik und Personal Care",
        "intro": "Kosmetikprodukte profitieren von digitalen Informationen.",
        "sections": [
            {
                "body": "<p>Verbraucher erwarten klare Informationen zu Inhaltsstoffen und Herkunft.</p>"
            }
        ]
    }
}

Globale Regeln

• category_path enthaelt nur Kategorien unterhalb von content_type; der Typ wird nicht wiederholt.
• Inhaltsserien: Mehrere Inhalte, die in exakt derselben Kategorie (identischer category_path) liegen, werden im Frontend automatisch als "Serie" betrachtet und am Ende des Artikels untereinander verlinkt (Serien-Floater).
• category_path darf 1 bis 3 Ebenen enthalten.
• category_definitions muss jede Ebene aus category_path definieren.
• tags darf leer sein; gesetzte Tags muessen in tag_definitions definiert sein. Sie erzeugen automatisch eine Tag-Cloud und eine Tag-Archivseite.
• Pflichtfelder fehlen, wenn sie null, leerer String oder leeres Array sind.
• Falls content.sections vorhanden ist, muss es ein Array sein und jede Section braucht body.
• .webp in Beispielen ist nur ein moegliches Bildformat; die tatsaechliche Extension muss zur hochgeladenen Datei bzw. zur url aus Media Ingest passen.
• Lokale strukturierte Bildfelder unter /content/.../img/... werden beim Speichern und Rendern auf eine eindeutig vorhandene gleichnamige Datei mit anderer erlaubter Bildendung normalisiert, falls die referenzierte Datei fehlt.
• Die API speichert HTML-Felder strukturell; die oeffentliche Ausgabe reduziert HTML auf einfache Formatierungen und sichere Links.

Abgelehnte Legacy-Felder

Fehler und Antworten