[{"data":1,"prerenderedAt":1265},["ShallowReactive",2],{"navigation":3,"search":178,"docs-page:\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys":852,"docs-page-surround:\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys":1260},[4,30,153,168],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.Getting Started",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Was ist der DPP?","\u002Fdocs\u002Fgetting-started\u002Fwas-ist-der-dpp","1.docs\u002F1.Getting Started\u002F1.Was ist der DPP","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Produktübersicht","\u002Fdocs\u002Fgetting-started\u002Fproduktubersicht","1.docs\u002F1.Getting Started\u002F2.Produktübersicht","i-lucide-layout-dashboard",{"title":20,"path":21,"stem":22,"icon":23},"Verwaltungsbereich vs. öffentlicher Bereich","\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend","1.docs\u002F1.Getting Started\u002F3.Frontend vs Backend","i-lucide-split",{"title":25,"path":26,"stem":27,"icon":28},"Glossar","\u002Fdocs\u002Fgetting-started\u002Fglossar","1.docs\u002F1.Getting Started\u002F4.Glossar","i-lucide-book-open",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Produktdokumentation","\u002Fdocs\u002Fproduktdokumentation","1.docs\u002F2.Produktdokumentation",[35,40,65,74,89,99,124],{"title":36,"path":37,"stem":38,"icon":39},"Einstieg in den DPP","\u002Fdocs\u002Fproduktdokumentation\u002Feinstieg-in-den-dpp","1.docs\u002F2.Produktdokumentation\u002F1.EInstieg in den DPP","i-lucide-rocket",{"title":41,"path":42,"stem":43,"children":44,"page":29},"Datenmodell","\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell","1.docs\u002F2.Produktdokumentation\u002F2.Datenmodell",[45,50,55,60],{"title":46,"path":47,"stem":48,"icon":49},"Languages","\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flanguages","1.docs\u002F2.Produktdokumentation\u002F2.Datenmodell\u002F1.Languages","i-lucide-languages",{"title":51,"path":52,"stem":53,"icon":54},"Attribute Groups","\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups","1.docs\u002F2.Produktdokumentation\u002F2.Datenmodell\u002F2.Attribute Groups","i-lucide-folder",{"title":56,"path":57,"stem":58,"icon":59},"Attribute Definitions","\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions","1.docs\u002F2.Produktdokumentation\u002F2.Datenmodell\u002F3.Attribute Definitions","i-lucide-list",{"title":61,"path":62,"stem":63,"icon":64},"Layers","\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers","1.docs\u002F2.Produktdokumentation\u002F2.Datenmodell\u002F4.Layers","i-lucide-layers",{"title":66,"path":67,"stem":68,"children":69,"page":29},"Assets","\u002Fdocs\u002Fproduktdokumentation\u002Fassets","1.docs\u002F2.Produktdokumentation\u002F3.Assets",[70],{"title":66,"path":71,"stem":72,"icon":73},"\u002Fdocs\u002Fproduktdokumentation\u002Fassets\u002Fupload","1.docs\u002F2.Produktdokumentation\u002F3.Assets\u002F1.Upload","i-lucide-image",{"title":75,"path":76,"stem":77,"children":78,"page":29},"Dashboard","\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard","1.docs\u002F2.Produktdokumentation\u002F4.Dashboard",[79,84],{"title":80,"path":81,"stem":82,"icon":83},"DPP Access","\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fdpp-access","1.docs\u002F2.Produktdokumentation\u002F4.Dashboard\u002F1.DPP Access","i-lucide-bar-chart-3",{"title":85,"path":86,"stem":87,"icon":88},"Numbers","\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fnumbers","1.docs\u002F2.Produktdokumentation\u002F4.Dashboard\u002F2.Numbers","i-lucide-hash",{"title":90,"path":91,"stem":92,"children":93,"page":29},"Import","\u002Fdocs\u002Fproduktdokumentation\u002Fimport","1.docs\u002F2.Produktdokumentation\u002F5.Import",[94],{"title":95,"path":96,"stem":97,"icon":98},"Datenimport","\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport","1.docs\u002F2.Produktdokumentation\u002F5.Import\u002F1.Import","i-lucide-upload",{"title":100,"path":101,"stem":102,"children":103,"page":29},"Organization","\u002Fdocs\u002Fproduktdokumentation\u002Forganization","1.docs\u002F2.Produktdokumentation\u002F6.Organization",[104,109,114,119],{"title":105,"path":106,"stem":107,"icon":108},"General","\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fgeneral","1.docs\u002F2.Produktdokumentation\u002F6.Organization\u002F1.General","i-lucide-building-2",{"title":110,"path":111,"stem":112,"icon":113},"DM Settings","\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fdm-settings","1.docs\u002F2.Produktdokumentation\u002F6.Organization\u002F2.DM Settings","i-lucide-database",{"title":115,"path":116,"stem":117,"icon":118},"Members","\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fmembers","1.docs\u002F2.Produktdokumentation\u002F6.Organization\u002F3.Members","i-lucide-users",{"title":120,"path":121,"stem":122,"icon":123},"API Keys","\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys","1.docs\u002F2.Produktdokumentation\u002F6.Organization\u002F4.API Keys","i-lucide-key",{"title":125,"path":126,"stem":127,"children":128,"page":29},"Dpp Page","\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page","1.docs\u002F2.Produktdokumentation\u002F7.DPP Page",[129,134,139,143,148],{"title":130,"path":131,"stem":132,"icon":133},"Domain & Slug","\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fdomain","1.docs\u002F2.Produktdokumentation\u002F7.DPP Page\u002F1.Domain","i-lucide-globe",{"title":135,"path":136,"stem":137,"icon":138},"Design","\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fdesign","1.docs\u002F2.Produktdokumentation\u002F7.DPP Page\u002F2.Design","i-lucide-palette",{"title":140,"path":141,"stem":142,"icon":49},"UI Translations","\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fui-translations","1.docs\u002F2.Produktdokumentation\u002F7.DPP Page\u002F3.UI Translations",{"title":144,"path":145,"stem":146,"icon":147},"Impressum","\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fimpressum","1.docs\u002F2.Produktdokumentation\u002F7.DPP Page\u002F4.Impressum","i-lucide-scale",{"title":149,"path":150,"stem":151,"icon":152},"404 Page","\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002F404-page","1.docs\u002F2.Produktdokumentation\u002F7.DPP Page\u002F5.404 Page","i-lucide-file-x",{"title":154,"path":155,"stem":156,"children":157,"page":29},"API & Developer","\u002Fdocs\u002Fapi-and-developer","1.docs\u002F3.API & Developer",[158,163],{"title":159,"path":160,"stem":161,"icon":162},"API Übersicht","\u002Fdocs\u002Fapi-and-developer\u002Fgeneral","1.docs\u002F3.API & Developer\u002F1.General","i-lucide-code",{"title":164,"path":165,"stem":166,"icon":167},"Authentication","\u002Fdocs\u002Fapi-and-developer\u002Fauthentication","1.docs\u002F3.API & Developer\u002F3.Authentication","i-lucide-shield",{"title":169,"path":170,"stem":171,"children":172,"page":29},"Guides","\u002Fdocs\u002Fguides","1.docs\u002F4.Guides",[173],{"title":174,"path":175,"stem":176,"icon":177},"Vom Setup zum fertigen Produktpass","\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp","1.docs\u002F4.Guides\u002FEinstiegs Guide zum ersten DPP","i-lucide-map",[179,183,189,194,199,204,209,212,217,222,227,230,235,240,245,250,255,260,265,268,273,278,283,288,293,298,303,308,313,318,323,326,331,336,341,347,352,357,360,365,370,375,380,385,390,393,397,401,405,409,414,419,424,427,431,435,439,443,448,453,458,463,466,471,476,481,485,490,495,500,505,508,513,518,523,528,533,538,541,546,551,556,561,564,568,573,576,580,584,588,593,598,603,608,611,614,619,624,629,632,637,642,647,652,655,660,665,670,673,678,683,688,693,698,703,706,711,714,718,721,725,730,733,738,743,746,750,754,757,762,767,772,777,780,785,790,795,800,805,808,812,817,822,827,832,837,842,847],{"id":11,"title":10,"titles":180,"content":181,"level":182},[],"Einführung in den Digital Product Passport – Hintergrund, Ziele und EU-Regulierung. Ein Digital Product Passport (DPP) ist ein digitaler Datensatz, der produktbezogene Informationen über den gesamten\nLebenszyklus eines Produkts hinweg zugänglich macht – von der Herstellung über die Nutzung bis zur Entsorgung und dem\nRecycling.",1,{"id":184,"title":185,"titles":186,"content":187,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fwas-ist-der-dpp#hintergrund-regulierung","Hintergrund & Regulierung",[10],"Die Europäische Union hat im Rahmen der Ökodesign-Verordnung für nachhaltige Produkte (ESPR) den digitalen\nProduktpass als Pflichtinstrument für eine Vielzahl von Produktkategorien eingeführt. Ziel ist es, die\nKreislaufwirtschaft zu stärken und die Transparenz entlang der Lieferkette zu erhöhen. Die ESPR gilt ab 2026 schrittweise für verschiedene Produktkategorien wie Textilien, Batterien, Elektronik und\nBaustoffe.",2,{"id":190,"title":191,"titles":192,"content":193,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fwas-ist-der-dpp#welche-informationen-enthält-ein-dpp","Welche Informationen enthält ein DPP?",[10],"Je nach Produktkategorie und Regulierung kann ein DPP unterschiedliche Datenpunkte umfassen. Typische Inhalte sind: KategorieBeispieleMaterialien & InhaltsstoffeRohstoffe, Gefahrstoffe, RecyclinganteilNachhaltigkeitsdatenCO₂-Fußabdruck, Energieverbrauch, WasserbedarfReparatur & WartungErsatzteilverfügbarkeit, ReparaturanleitungenEntsorgung & RecyclingSortiervorgaben, DemontagehinweiseProduktidentifikationSeriennummer, GTIN, Batch-Nummer",{"id":195,"title":196,"titles":197,"content":198,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fwas-ist-der-dpp#wie-funktioniert-der-dpp-technisch","Wie funktioniert der DPP technisch?",[10],"Ein DPP wird über einen eindeutigen digitalen Identifikator (z. B. einen QR-Code oder einen Data Matrix-Code) mit\ndem physischen Produkt verknüpft. Beim Scannen wird der Nutzer zu einer maschinenlesbaren Datenquelle weitergeleitet,\nwelche die strukturierten Produktinformationen enthält. Produkt  →  QR-Code \u002F Etikett  →  URL \u002F API  →  DPP-Daten",{"id":200,"title":201,"titles":202,"content":203,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fwas-ist-der-dpp#wer-profitiert-vom-dpp","Wer profitiert vom DPP?",[10],"Hersteller – Erfüllung gesetzlicher Pflichten und Stärkung des MarkenvertrauensHändler & Importeure – Nachweis der Produktkonformität gegenüber BehördenVerbraucher – Informierte Kaufentscheidungen und ReparaturoptionenRecycler – Schnelle Identifikation von Materialien und ZerlegungsanweisungenBehörden – Digitale Marktüberwachung und Compliance-Prüfung",{"id":205,"title":206,"titles":207,"content":208,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fwas-ist-der-dpp#die-dpp-plattform-als-lösung","Die DPP-Plattform als Lösung",[10],"Unsere Plattform bietet die technische Infrastruktur, um DPPs normkonform zu erstellen, zu pflegen und über eine\nREST-API auszuliefern. Die flexible Datenmodellierung erlaubt es, sich an unterschiedliche Produktkategorien und\nregulatorische Anforderungen anzupassen, ohne die Systemarchitektur zu verändern.",{"id":16,"title":15,"titles":210,"content":211,"level":182},[],"Überblick über die DPP-Plattform – Funktionen, Architektur und Einsatzbereiche. Die DPP-Plattform ist eine cloudbasierte Lösung zur Erstellung, Verwaltung und Veröffentlichung von Digital\nProduct Passports (DPP). Sie ermöglicht Unternehmen, produktbezogene Nachhaltigkeits- und Kreislaufinformationen\nstrukturiert zu erfassen und entlang der gesamten Lieferkette bereitzustellen.",{"id":213,"title":214,"titles":215,"content":216,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fproduktubersicht#was-bietet-die-plattform","Was bietet die Plattform?",[15],"Die DPP-Plattform deckt den gesamten Lebenszyklus eines digitalen Produktpasses ab – von der Dateneingabe über die\nVerwaltung bis zur Ausgabe über eine REST-API: Flexibles Datenmodell – Definiere beliebige Attribute, Attributgruppen und Layer, um Produktinformationen präzise\nzu strukturieren.Mehrsprachigkeit – Pflege Inhalte in mehreren Sprachen und liefere DPPs weltweit in der richtigen Sprache aus.Asset-Verwaltung – Lade Bilder, Dokumente und andere Mediendateien hoch und verknüpfe sie mit deinen Produkten.API-First-Ansatz – Alle Daten sind über eine dokumentierte REST-API abrufbar und integrierbar.Zugangssteuerung – Verwalte API-Zugriffsschlüssel granular nach Berechtigungen und Projekten.",{"id":218,"title":219,"titles":220,"content":221,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fproduktubersicht#typische-einsatzbereiche","Typische Einsatzbereiche",[15],"BereichBeschreibungEU-ComplianceErfüllung der Anforderungen der EU-Ökodesignverordnung (ESPR) für elektronische Geräte, Textilien und weitere Produktkategorien.LieferkettenmanagementTransparente Weitergabe von Materialien, Herkunftsnachweisen und Recyclinghinweisen an Handelspartner und Endkunden.ProduktkommunikationBereitstellung von QR-Code-verlinkten Produktinformationsseiten für Verbraucher, Reparaturbetriebe und Recycler.",{"id":223,"title":224,"titles":225,"content":226,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fproduktubersicht#architektur-auf-einen-blick","Architektur auf einen Blick",[15],"Die Plattform ist in drei Hauptschichten aufgebaut: SchichtBeschreibungDatenmodellDefinition von Sprachen, Attributen und LayernContent ManagementErfassung und Pflege von Produktdaten und AssetsAPI-AusgabeBereitstellung der Daten für externe Systeme und Apps Neu hier? Starte mit dem Einstieg in den DPP und lerne,\nwie du deinen ersten Produktpass anlegst.",{"id":21,"title":20,"titles":228,"content":229,"level":182},[],"Unterschiede zwischen dem internen Verwaltungsbereich und dem öffentlichen Bereich der DPP-Plattform – eine Einführung für Einsteiger. Die DPP-Plattform besteht aus zwei klar voneinander getrennten Anwendungen, die auf derselben Datenbasis arbeiten:\ndem Verwaltungsbereich und dem öffentlichen Bereich. Beide haben unterschiedliche Aufgaben, Zielgruppen,\nAuthentifizierungsmodelle und Zugriffspfade. Diese Seite erklärt die Unterschiede in einfachen Worten, ohne tiefes\ntechnisches Vorwissen vorauszusetzen. Kurz gesagt: Im Verwaltungsbereich werden Daten erfasst, strukturiert und administriert – im öffentlichen\nBereich werden diese Daten ausgeliefert und für externe Nutzer dargestellt.",{"id":231,"title":232,"titles":233,"content":234,"level":188},"\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend#architektur-im-überblick","Architektur im Überblick",[20],"Die Plattform ist als entkoppeltes System aufgebaut: Der Verwaltungsbereich ist eine authentifizierte Webanwendung, die ausschließlich für berechtigte\nOrganisationsmitglieder zugänglich ist. Daten werden hier über Eingabemasken, Importe und API Keys gepflegt.Der öffentliche Bereich ist eine zustandslose Auslieferungsschicht, die strukturierte Produktdaten ohne Login\nüber eine URL (typischerweise via QR-Code) bereitstellt.Beide Bereiche greifen über dieselbe REST-API auf den gemeinsamen Datenbestand zu.",{"id":236,"title":237,"titles":238,"content":239,"level":188},"\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend#direkter-vergleich","Direkter Vergleich",[20],"AspektVerwaltungsbereichÖffentlicher BereichZielgruppeInterne Nutzer: Produkt-, Daten-, IT- und Compliance-TeamsExterne Nutzer: Endkunden, Händler, Recycler, BehördenZweckDaten pflegen, strukturieren und verwaltenDaten ansprechend und verständlich anzeigenZugangLogin unter my.digital-product-passport.cloudÖffentlich per QR-Code oder Link, kein Login nötigInhaltDatenmodell, Produktpässe, Assets, Benutzer, API KeysLogo, Farben, Texte, ProduktinformationenSichtbarkeitNur für berechtigte Mitglieder der OrganisationÖffentlich im InternetTypische Frage„Wie pflege ich die Daten meiner Produkte?\"„Wie sieht mein Produktpass für den Kunden aus?\"",{"id":241,"title":242,"titles":243,"content":244,"level":188},"\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend#was-passiert-im-verwaltungsbereich","Was passiert im Verwaltungsbereich?",[20],"Der Verwaltungsbereich – auch Admin-Oberfläche genannt – ist die geschützte Arbeitsumgebung deiner\nOrganisation. Hier findet die eigentliche Pflege- und Konfigurationsarbeit statt. Typische Aufgaben im Verwaltungsbereich sind: Datenmodell definieren – Attribute, Attributgruppen und Layer für die Produktstruktur festlegenProduktpässe pflegen – Stammdaten, Materialinformationen und Nachhaltigkeitskennzahlen erfassenAssets verwalten – Bilder, PDFs und Dokumente hochladen und mit Produktpässen verknüpfenÜbersetzungen pflegen – Inhalte in mehreren Sprachen bereitstellenZugriff steuern – Mitglieder einladen, Rollen vergeben und API Keys verwalten Die ausführliche Beschreibung aller Bereiche der Admin-Oberfläche findest du in der\nProduktdokumentation.",{"id":246,"title":247,"titles":248,"content":249,"level":188},"\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend#was-passiert-im-öffentlichen-bereich","Was passiert im öffentlichen Bereich?",[20],"Der öffentliche Bereich – die DPP-Seite – ist das, was sichtbar wird, wenn jemand den QR-Code auf einem\nProdukt scannt oder den zugehörigen Link aufruft. Er stellt die produktbezogenen Daten in einer für Endnutzer\noptimierten Form bereit. Typische Merkmale des öffentlichen Bereichs: Öffentlich erreichbar – Ohne Login direkt per Browser oder QR-Code-ScanAnpassbares Design – Logo, Farben, Schriftart und Eckenradius passen zum Corporate Design der OrganisationMehrsprachig – Inhalte werden automatisch in der passenden Sprache ausgespieltStrukturierte Anzeige – Attribute werden als Tabs oder Quick-Access-Felder dargestelltEigene Domain möglich – Die DPP-Seite kann unter einer organisationseigenen Domain ausgespielt werden Wie du das visuelle Erscheinungsbild der öffentlichen DPP-Seite anpasst, erfährst du unter\nDPP Page → Design.",{"id":251,"title":252,"titles":253,"content":254,"level":188},"\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend#wie-hängen-verwaltungsbereich-und-öffentlicher-bereich-zusammen","Wie hängen Verwaltungsbereich und öffentlicher Bereich zusammen?",[20],"Beide Bereiche sind keine voneinander isolierten Systeme – sie teilen sich dieselbe Datenbasis. Sobald im\nVerwaltungsbereich Inhalte geändert und gespeichert werden, wirken sich diese Änderungen unmittelbar auf die\nöffentliche DPP-Seite aus. Verwaltungsbereich  →  Daten & Konfiguration  →  Öffentlicher Bereich\n        ↑                                                ↓\n   Admin-Login                                  QR-Code \u002F Public Link",{"id":256,"title":257,"titles":258,"content":259,"level":188},"\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend#wer-macht-was","Wer macht was?",[20],"RolleArbeitet im …Typische TätigkeitData Steward \u002F RedaktionVerwaltungsbereichPflegt Produktdaten und ÜbersetzungenDesigner \u002F MarkenteamVerwaltungsbereich (DPP Page)Definiert Logo, Farben und Schriftart der DPP-SeiteEntwickler \u002F ITVerwaltungsbereich & APIBindet Daten per REST-API in Systeme anEndkunde \u002F BehördeÖffentlicher BereichScannt QR-Code und liest ProduktinformationenRecycler \u002F ReparaturÖffentlicher BereichRuft Materialinfos und Demontagehinweise ab",{"id":261,"title":262,"titles":263,"content":264,"level":188},"\u002Fdocs\u002Fgetting-started\u002Ffrontend-vs-backend#weiterführende-themen","Weiterführende Themen",[20],"Design der DPP-Seite (öffentlicher Bereich) – Logo, Farben und\nSchriften anpassenDomain konfigurieren (öffentlicher Bereich) – Eigene Domain für die\nDPP-Seite einrichtenUI Translations (öffentlicher Bereich) – Buttons und Texte\nder öffentlichen Seite übersetzenEinstieg in den DPP (Verwaltungsbereich) – Erste Schritte in der\nAdmin-OberflächeDatenmodell (Verwaltungsbereich) – Aufbau von Sprachen,\nAttributen und LayernProduktübersicht – Funktionen und Architektur im Überblick Du bist neu? Lies zuerst Was ist der DPP?, dann die\nProduktübersicht – und kehre danach hierher zurück, um Verwaltungsbereich\nund öffentlichen Bereich sicher auseinanderhalten zu können.",{"id":26,"title":25,"titles":266,"content":267,"level":182},[],"Wichtige Begriffe und Definitionen rund um den Digitalen Produktpass und die DPP-Plattform.",{"id":269,"title":270,"titles":271,"content":272,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#a","A",[25],"API Key\nEin Zugriffsschlüssel, der die programmatische Kommunikation mit der DPP-Plattform über die REST-API ermöglicht. API Keys werden unter Organization → API Keys erstellt und können mit Rollen (Member\u002FOwner) und optionalem Ablaufdatum versehen werden. Attribute Definition\nDie Definition eines einzelnen Datenfeldes innerhalb des Datenmodells. Jede Definition legt Typ, Gruppenzugehörigkeit, Durchsuchbarkeit und weitere Eigenschaften fest. Verwaltet unter Data Model → Attribute Definitions. Attribute Group\nEine thematische Gruppierung von Attribute Definitions. Im Produktpass werden Attribute Groups als Tabs oder Abschnitte dargestellt (z.B. „Stammdaten\", „Technische Attribute\", „Bilder\"). Asset\nEine Mediendatei (Bild, Dokument, PDF etc.), die in der Plattform hochgeladen und mit Produktpässen verknüpft werden kann. Verwaltet unter Assets.",{"id":274,"title":275,"titles":276,"content":277,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#b","B",[25],"Batch\nEin Layer-Typ, der eine Charge oder Produktionslos darstellt. Batches haben einen Parent Key, der auf den übergeordneten Article verweist.",{"id":279,"title":280,"titles":281,"content":282,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#d","D",[25],"Display Area\nBestimmt, wo ein Attribut im Produktpass angezeigt wird. Verfügbare Optionen: Attribute List (Standard) und Quick Access (prominente Darstellung). DPP (Digital Product Passport)\nEin digitaler Datensatz, der produktbezogene Informationen über den gesamten Lebenszyklus zugänglich macht – von der Herstellung über die Nutzung bis zum Recycling. DPP Page\nDie öffentlich zugängliche Seite eines Produktpasses, die über einen QR-Code oder Link erreichbar ist. Design, Domain, Übersetzungen und Impressum werden unter DPP Page konfiguriert. DPP Searchable\nEine Eigenschaft einer Attribute Definition. Wenn aktiviert, ist das Attribut auf der öffentlichen DPP-Seite durchsuchbar.",{"id":284,"title":285,"titles":286,"content":287,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#e","E",[25],"Entity\nEin einzelner Datensatz innerhalb der Plattform – also ein konkreter Produktpass. Jede Entity hat einen Key, einen Layer, optionale Entity Labels und Attributwerte. Entity Label\nDer sprachabhängige Anzeigename einer Entity, z.B. „Electronic Steel Chips (DE)\". ESPR (Ecodesign for Sustainable Products Regulation)\nDie EU-Ökodesignverordnung für nachhaltige Produkte, die den Digitalen Produktpass als Pflichtinstrument einführt.",{"id":289,"title":290,"titles":291,"content":292,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#i","I",[25],"Import\nFunktion zum Massenimport von Daten per JSON-Datei. Es können Attribute Groups, Attribute Definitions und Entities importiert werden.",{"id":294,"title":295,"titles":296,"content":297,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#k","K",[25],"Key\nEin eindeutiger technischer Identifikator für Objekte im System (z.B. DPP_Stammdaten, ATTRIBUT_GTIN, Article). Keys sind URL-safe und können nach dem Erstellen nicht mehr geändert werden.",{"id":299,"title":300,"titles":301,"content":302,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#l","L",[25],"Language Dependent\nEine Eigenschaft einer Attribute Definition. Wenn aktiviert, kann der Wert pro konfigurierter Sprache unterschiedlich gepflegt werden. Layer\nDie oberste Strukturebene im Datenmodell. Layers definieren, auf welcher Produktebene Daten organisiert werden (z.B. Article, Batch, Serial). Verwaltet unter Data Model → Layers.",{"id":304,"title":305,"titles":306,"content":307,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#o","O",[25],"Organization\nDie Organisationseinheit innerhalb der DPP-Plattform. Enthält Einstellungen wie Name, Adresse, Mitglieder und API Keys. Organization Slug\nDer URL-Bestandteil, der die Organisation in der DPP-Frontend-URL identifiziert (z.B. contsult-gmbh).",{"id":309,"title":310,"titles":311,"content":312,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#p","P",[25],"Parent Key\nVerknüpft einen untergeordneten Produktpass (z.B. Batch oder Serial) mit seinem übergeordneten Eintrag. Product Passport\nSiehe → Entity.",{"id":314,"title":315,"titles":316,"content":317,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#s","S",[25],"Searchable\nEine Eigenschaft einer Attribute Definition. Wenn aktiviert, wird das Attribut in der internen Admin-Suche berücksichtigt. Serial\nEin Layer-Typ für einzelne Seriennummern. Serials haben einen Parent Key, der auf den übergeordneten Batch oder Article verweist.",{"id":319,"title":320,"titles":321,"content":322,"level":188},"\u002Fdocs\u002Fgetting-started\u002Fglossar#u","U",[25],"UI Translations\nAnpassbare Texte der öffentlichen DPP-Seite (Buttons, Platzhalter, Überschriften). Verwaltet unter DPP Page → UI Translations.",{"id":37,"title":36,"titles":324,"content":325,"level":182},[],"Erste Schritte mit der Contsult DPP-Plattform – Anmeldung, Navigation und erster Produktpass. Dieser Abschnitt führt dich durch die ersten Schritte mit der Contsult DPP-Plattform. Am Ende wirst du die Admin-Oberfläche kennen und deinen ersten Produktpass erstellt haben.",{"id":327,"title":328,"titles":329,"content":330,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Feinstieg-in-den-dpp#zugang-zur-plattform","Zugang zur Plattform",[36],"Die DPP-Plattform erreichst du unter my.digital-product-passport.cloud. Melde dich mit deinen Zugangsdaten an. Falls du noch keinen Account hast, wende dich an einen Administrator deiner Organisation, der dich unter Organization → Members einladen kann.",{"id":332,"title":333,"titles":334,"content":335,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Feinstieg-in-den-dpp#die-admin-oberfläche","Die Admin-Oberfläche",[36],"Nach dem Login landest du in der Admin-Oberfläche. Die Navigation befindet sich in der linken Sidebar und ist in folgende Bereiche gegliedert: BereichBeschreibungDashboardZugriffsstatistiken (DPP Access) und Kennzahlen (Numbers)Product PassportsVerwaltung aller Produktpässe – Anlegen, Bearbeiten, LöschenAssetsUpload und Verwaltung von Mediendateien (Bilder, Dokumente)Data ModelDefinition von Sprachen, Attributgruppen, Attributen und LayernImportMassenimport von Daten per JSON-DateiOrganizationOrganisationseinstellungen, Mitglieder und API KeysDPP PageKonfiguration der öffentlichen Produktpass-Seite",{"id":337,"title":338,"titles":339,"content":340,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Feinstieg-in-den-dpp#deinen-ersten-produktpass-erstellen","Deinen ersten Produktpass erstellen",[36],"",{"id":342,"title":343,"titles":344,"content":345,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Feinstieg-in-den-dpp#voraussetzungen","Voraussetzungen",[36,338],"Bevor du einen Produktpass anlegen kannst, müssen folgende Elemente im Datenmodell konfiguriert sein: Mindestens eine Sprache (Data Model → Languages)Mindestens eine Attribute Group (Data Model → Attribute Groups)Die gewünschten Attribute Definitions (Data Model → Attribute Definitions)Mindestens ein Layer (Data Model → Layers)",3,{"id":348,"title":349,"titles":350,"content":351,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Feinstieg-in-den-dpp#schritt-für-schritt","Schritt-für-Schritt",[36,338],"Navigiere zu Product Passports in der Sidebar.Klicke oben rechts auf \"+ New\".Vergib einen eindeutigen Key (z.B. PRD-mein-produkt-001).Wähle den gewünschten Layer (z.B. „Artiekl\").Optional: Trage einen Parent Key ein, wenn es sich um eine Unter-Entity handelt.Pflege die Entity Labels pro Sprache.Wechsle in die Tabs der Attribute Groups und füge über \"+ Add attribute\" die gewünschten Attribute hinzu.Klicke auf \"Save\". Du kannst den Produktpass jederzeit über das Drei-Punkte-Menü (⋮) in der Listenansicht aufrufen und bearbeiten.",{"id":353,"title":354,"titles":355,"content":356,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Feinstieg-in-den-dpp#nächste-schritte","Nächste Schritte",[36],"Datenmodell verstehen – Lerne, wie Sprachen, Attribute und Layer zusammenwirken.Assets hochladen – Verknüpfe Bilder und Dokumente mit deinen Produktpässen.API nutzen – Greife programmatisch auf deine Daten zu.",{"id":47,"title":46,"titles":358,"content":359,"level":182},[],"Verwaltung der Sprachen für mehrsprachige Labels und Inhalte im DPP-System. Das Languages-Modul verwaltet die Sprachen, in denen Inhalte (Labels, Bezeichnungen) im gesamten System gepflegt werden können. Die hier definierten Sprachen erscheinen als Auswahl in Attribute Groups, Attribute Definitions und Layers. Der Bereich befindet sich unter Admin → Data Model → Languages (\u002Fadmin\u002Flanguages).",{"id":361,"title":362,"titles":363,"content":364,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flanguages#listenansicht","Listenansicht",[46],"Die Listenansicht zeigt alle konfigurierten Sprachen in einer Tabelle mit den Spalten Short name, Key, ISO und Default.",{"id":366,"title":367,"titles":368,"content":369,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flanguages#ui-elemente-der-listenansicht","UI-Elemente der Listenansicht",[46,362],"ElementBeschreibungSuchfeldOben rechts – filtert die Sprachenliste\"+ New\" ButtonErstellt eine neue Sprache\"Display\" ButtonPasst die sichtbaren Spalten anEdit-Icon (Stift)In jeder Zeile – öffnet die DetailansichtPaginierungAm unteren Rand der Tabelle",{"id":371,"title":372,"titles":373,"content":374,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flanguages#detailansicht","Detailansicht",[46],"Die Detailansicht einer Sprache zeigt alle Felder inkl. UUID, Key, ISO Code, Is Default, Short name und Long name.",{"id":376,"title":377,"titles":378,"content":379,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flanguages#felder","Felder",[46],"FeldTypPflichtBeschreibungID (UUID)Text (auto)–Automatisch generierte eindeutige ID, z.B. 698ee3cca7c24cacdbceaec3KeyText-InputJaKurzschlüssel der Sprache, z.B. deISO CodeDropdownJaISO-Sprachcode. Auswahl aus ISO-Standard, z.B. German (de). Unterstützt auch regionale Varianten wie de-DEIs DefaultCheckboxNeinMarkiert die Standard-\u002FFallback-Sprache des SystemsShort nameText-InputJaKurzbezeichnung zur Anzeige, z.B. DELong nameText-InputJaLangbezeichnung, z.B. deutsch",{"id":381,"title":382,"titles":383,"content":384,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flanguages#neue-sprache-anlegen","Neue Sprache anlegen",[46],"Klicke auf den \"+ New\" Button in der Listenansicht.Fülle die Pflichtfelder Key, ISO Code, Short name und Long name aus.Aktiviere optional Is Default, falls diese Sprache als Systemstandard dienen soll.Klicke auf \"Save\", um die Sprache zu speichern. Es sollte immer genau eine Sprache als Default markiert sein. Diese dient als Fallback, wenn für eine andere Sprache kein Label gepflegt ist.",{"id":386,"title":387,"titles":388,"content":389,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flanguages#auswirkungen-auf-andere-module","Auswirkungen auf andere Module",[46],"Die hier definierten Sprachen werden in folgenden Modulen referenziert: Attribute Groups – sprachabhängige Labels pro GruppeAttribute Definitions – sprachabhängige Labels und Werte (bei Language Dependent-Attributen)Layers – sprachabhängige Labels pro Layer",{"id":52,"title":51,"titles":391,"content":392,"level":182},[],"Thematische Gruppierung von Attributen zur Strukturierung der Produktdaten. Attribute Groups organisieren die Attribute Definitions in thematische Gruppen. Sie werden im Product Passport als Tabs oder Abschnitte dargestellt und ermöglichen eine übersichtliche Strukturierung der Produktdaten. Der Bereich befindet sich unter Admin → Data Model → Attribute Groups (\u002Fadmin\u002Fattribute-groups).",{"id":394,"title":362,"titles":395,"content":396,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups#listenansicht",[51],"Die Listenansicht zeigt alle Attributgruppen mit Label, Key, Order und optionalem Icon.",{"id":398,"title":367,"titles":399,"content":400,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups#ui-elemente-der-listenansicht",[51,362],"ElementBeschreibungSprachfilterOben rechts – Dropdown zur Auswahl der Anzeigesprache (z.B. \"DE (deutsch)\")SuchfeldFiltert die Gruppen nach Name oder Key\"+ New\" ButtonErstellt eine neue Attributgruppe\"Display\" ButtonPasst die sichtbaren Spalten anEdit-Icon (Stift)Pro Zeile – öffnet die Detailansicht",{"id":402,"title":372,"titles":403,"content":404,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups#detailansicht",[51],"Die Detailansicht zeigt alle Felder einer Attributgruppe inkl. dem sprachabhängigen Label.",{"id":406,"title":377,"titles":407,"content":408,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups#felder",[51],"FeldTypPflichtBeschreibungID (UUID)Text (auto)–Automatisch generierte eindeutige ID, z.B. 6977386e11a5d2ef2db511f3KeyText-InputJaEindeutiger technischer Schlüssel, z.B. DPP_StammdatenOrderZahl-InputNeinSortierreihenfolge der Gruppe (Ganzzahl)IconText-InputNeinIcon-Name von lucide.dev. Wichtig: Prefix i-lucide- verwenden, z.B. i-lucide-settingsLabel (per language)Text-Input (pro Sprache)NeinAnzeigename pro konfigurierter Sprache. Sprachauswahl über Dropdown oben rechts",{"id":410,"title":411,"titles":412,"content":413,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups#neue-attributgruppe-anlegen","Neue Attributgruppe anlegen",[51],"Klicke auf den \"+ New\" Button in der Listenansicht.Vergib einen eindeutigen Key (z.B. DPP_Nachhaltigkeit).Setze die gewünschte Order für die Sortierung.Optional: Trage ein Icon ein (z.B. i-lucide-leaf).Wechsle über den Sprachfilter die Sprache und pflege die Labels pro Sprache.Klicke auf \"Save\". Der Key kann nach dem Erstellen nicht mehr geändert werden. Wähle einen aussagekräftigen, konsistenten Schlüssel.",{"id":415,"title":416,"titles":417,"content":418,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups#beispiel-konfigurierte-gruppen","Beispiel: Konfigurierte Gruppen",[51],"Label (DE)KeyOrderIconStammdatenDPP_Stammdaten1–Technische AttributeDPP_Technische_Attribute3–BilderDPP_Bilder5–DokumenteDPP_Dokumente7–Erweiterungen & ErsatzteileDPP_Erweiterungen_&_Ersatzteile9–Clothingclothing1i-lucide-keyBeautybeauty5i-lucide-settingsToystoys4i-lucide-calendarElectronicselectronics2i-lucide-settingsToolstools3i-lucide-settings",{"id":420,"title":421,"titles":422,"content":423,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-groups#zusammenhang-mit-attribute-definitions","Zusammenhang mit Attribute Definitions",[51],"Jede Attribute Definition gehört zu genau einer Attribute Group. Die Gruppe bestimmt, in welchem Abschnitt das Attribut im Produktpass angezeigt wird.",{"id":57,"title":56,"titles":425,"content":426,"level":182},[],"Definition der einzelnen Datenfelder für Digitale Produktpässe – Typen, Optionen und Konfiguration. Attribute Definitions bilden das Kernstück des Datenmodells. Jede Definition beschreibt ein einzelnes Datenfeld, das an einem Digitalen Produktpass gepflegt werden kann. Hier wird festgelegt, welchen Typ ein Attribut hat, ob es durchsuchbar oder sprachabhängig ist und wie es angezeigt wird. Der Bereich befindet sich unter Admin → Data Model → Attribute Definitions (\u002Fadmin\u002Fattribute-definitions).",{"id":428,"title":362,"titles":429,"content":430,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#listenansicht",[56],"Die Listenansicht zeigt alle Definitionen mit den Spalten Label, Key, Group, Type, List, Language Dependent, Display Area, Unique, Searchable, DPP Searchable und Order. Die Tabelle ist horizontal scrollbar.",{"id":432,"title":367,"titles":433,"content":434,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#ui-elemente-der-listenansicht",[56,362],"ElementBeschreibungSprachfilterOben rechts – Dropdown zur Auswahl der AnzeigespracheSuchfeldFiltert die Definitionen nach Name oder Key\"+ New\" ButtonErstellt eine neue Attributdefinition\"Display\" ButtonPasst die sichtbaren Spalten anHorizontales ScrollenDie Tabelle kann seitwärts gescrollt werden, um alle Spalten zu sehenEdit-Icon (Stift)Pro Zeile – öffnet die DetailansichtPaginierungAm unteren Rand (z.B. 5 Seiten bei 90 Einträgen)",{"id":436,"title":372,"titles":437,"content":438,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#detailansicht",[56],"Die Detailansicht zeigt alle Felder einer Attributdefinition.",{"id":440,"title":377,"titles":441,"content":442,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#felder",[56],"FeldTypPflichtBeschreibungID (UUID)Text (auto)–Automatisch generierte ID, z.B. 6977389a11a5d2ef2db511f8KeyText-InputJaEindeutiger technischer Schlüssel, z.B. ATTRIBUT_EF000177GroupDropdownJaZuordnung zu einer Attribute Group. Auswahl aus allen angelegten GruppenTypeDropdownJaDatentyp des Attributs (siehe Tabelle unten)Is ListCheckboxNeinWenn aktiviert: Attribut kann mehrere Werte enthalten (Array)UniqueCheckboxNeinWenn aktiviert: Wert muss systemweit eindeutig seinSearchableCheckboxNeinWenn aktiviert: Attribut wird in der internen Admin-Suche berücksichtigtDPP SearchableCheckboxNeinWenn aktiviert: Attribut wird auf der öffentlichen DPP-Seite durchsuchbarLanguage DependentCheckboxNeinWenn aktiviert: Wert kann pro Sprache unterschiedlich gepflegt werdenDisplay AreaDropdownNeinBestimmt den Anzeigebereich (siehe unten)OrderZahl-InputNeinSortierreihenfolge innerhalb der GruppeLabel (per language)Text-Input (pro Sprache)NeinAnzeigename pro Sprache",{"id":444,"title":445,"titles":446,"content":447,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#verfügbare-datentypen","Verfügbare Datentypen",[56],"TypBeschreibungtextFreitextfeld für beliebige ZeichenkettennumberNumerischer Wert (Ganzzahl oder Dezimalzahl)dateDatumswertbooleanJa\u002FNein-Wert (Wahrheitswert)documentDokument-Upload (Dateien wie PDF etc.)imageBild-Upload (Bilddateien)linkURL\u002FVerlinkung",{"id":449,"title":450,"titles":451,"content":452,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#display-areas","Display Areas",[56],"OptionBeschreibungAttribute ListStandardanzeige in der Attributliste des ProduktpassesQuick AccessSchnellzugriff – prominentere Darstellung für häufig benötigte Attribute",{"id":454,"title":455,"titles":456,"content":457,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#neue-attributdefinition-anlegen","Neue Attributdefinition anlegen",[56],"Klicke auf den \"+ New\" Button in der Listenansicht.Vergib einen eindeutigen Key (z.B. ATTRIBUT_Gewicht).Wähle die zugehörige Group aus dem Dropdown.Wähle den passenden Type (z.B. number für numerische Werte).Konfiguriere die optionalen Flags:\nIs List – für MehrfachwerteUnique – für systemweit eindeutige Werte (z.B. Artikelnummer)Searchable \u002F DPP Searchable – für die DurchsuchbarkeitLanguage Dependent – für mehrsprachige WerteWähle die gewünschte Display Area.Pflege die Labels pro Sprache über den Sprachfilter.Klicke auf \"Save\". Der Key kann nach dem Erstellen nicht mehr geändert werden. Verwende ein konsistentes Namensschema (z.B. ATTRIBUT_\u003CBezeichnung>).",{"id":459,"title":460,"titles":461,"content":462,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Fattribute-definitions#beispieldaten-auszug","Beispieldaten (Auszug)",[56],"Label (DE)KeyGroupTypeArtikelnummerATTRIBUT_ArtikelnummerStammdatenTextGTINATTRIBUT_GTINStammdatenTextGewicht Brutto kgATTRIBUT_EF000167Technische AttributeTextProduktdatenblattATTRIBUT_ProduktdatenblattDokumenteDocumentGPSR-SicherheitshinweiseATTRIBUT_GPSRDokumenteDocumentAnwendungsbildATTRIBUT_AnwendungBilderImageFreistellerbildATTRIBUT_FreistellerbildBilderImage",{"id":62,"title":61,"titles":464,"content":465,"level":182},[],"Definition der übergeordneten Produktebenen im DPP-System. Layers definieren die übergeordneten Produktebenen im DPP-System. Sie bestimmen, auf welcher Ebene Produkte und deren Attribute organisiert werden. Die Darstellung erfolgt als sortierbare Karten mit Drag-and-Drop-Unterstützung. Der Bereich befindet sich unter Admin → Data Model → Layers (\u002Fadmin\u002Flayers).",{"id":467,"title":468,"titles":469,"content":470,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#übersicht","Übersicht",[61],"Die Layers-Übersicht zeigt alle konfigurierten Layer als sortierbare Karten.",{"id":472,"title":473,"titles":474,"content":475,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#ui-elemente","UI-Elemente",[61,468],"ElementBeschreibung\"+ Add Layer\" ButtonOben rechts – erstellt einen neuen LayerSortierbare KartenMit Drag-Handle und Auf-\u002FAb-PfeilenNummerierung#1, #2, … zeigt die aktuelle ReihenfolgeEdit-Icon (Stift)Öffnet den Edit-Dialog als Modal\"Save Order\" ButtonSpeichert die Reihenfolge der Layer",{"id":477,"title":478,"titles":479,"content":480,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#edit-dialog","Edit-Dialog",[61],"Der Edit-Dialog eines Layers wird als Modal-Fenster geöffnet und enthält alle konfigurierbaren Felder.",{"id":482,"title":377,"titles":483,"content":484,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#felder",[61],"FeldTypPflichtBeschreibungKeyText-InputJaEindeutiger technischer Schlüssel, z.B. ArticleIconText-InputNeinIcon-Name von lucide.dev. Wichtig: Prefix i-lucide- verwenden, z.B. i-lucide-layersColorColor-PickerNeinFarbwähler für die visuelle Darstellung des LayersLabelsText-Input (pro Sprache)NeinAnzeigename pro konfigurierter Sprache, z.B. DE: \"Artikel\"",{"id":486,"title":487,"titles":488,"content":489,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#neuen-layer-anlegen","Neuen Layer anlegen",[61],"Klicke auf den \"+ Add Layer\" Button in der Übersicht.Vergib einen eindeutigen Key (z.B. Variant).Optional: Trage ein Icon ein (z.B. i-lucide-box).Optional: Wähle eine Color über den Color-Picker.Pflege die Labels pro konfigurierter Sprache.Klicke auf \"Update\", um den Layer zu speichern.",{"id":491,"title":492,"titles":493,"content":494,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#reihenfolge-ändern","Reihenfolge ändern",[61],"Die Reihenfolge der Layer bestimmt deren Anzeigeposition in der Anwendung. Es gibt zwei Möglichkeiten, die Reihenfolge zu ändern: Drag and Drop – Ziehe eine Karte über den Drag-Handle an die gewünschte Position.Pfeiltasten – Nutze die Auf-\u002FAb-Pfeile auf der Karte, um die Position schrittweise anzupassen. Klicke anschließend auf \"Save Order\", um die neue Reihenfolge zu speichern.",{"id":496,"title":497,"titles":498,"content":499,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#beispiel-konfigurierter-layer","Beispiel: Konfigurierter Layer",[61],"#Label (DE)KeyIconColor1ArtikelArticlei-lucide-layersSchwarz (#000000)",{"id":501,"title":502,"titles":503,"content":504,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdatenmodell\u002Flayers#zusammenhang-mit-dem-datenmodell","Zusammenhang mit dem Datenmodell",[61],"Layers bilden die oberste Strukturebene im Datenmodell. Zusammen mit Attribute Groups und Attribute Definitions definieren sie den vollständigen Aufbau eines Digitalen Produktpasses: Layer (z.B. Artikel)\n├── Attribute Group (z.B. Stammdaten)\n│   ├── Attribute Definition (z.B. Artikelnummer)\n│   ├── Attribute Definition (z.B. GTIN)\n│   └── ...\n├── Attribute Group (z.B. Technische Attribute)\n│   ├── Attribute Definition (z.B. Gewicht Brutto)\n│   └── ...\n└── ...",{"id":71,"title":66,"titles":506,"content":507,"level":182},[],"Upload und Verwaltung von Mediendateien – Bilder, Dokumente und Ordner. Der Assets-Bereich ermöglicht den Upload und die Verwaltung aller Mediendateien, die mit Produktpässen verknüpft werden können. Dazu gehören Bilder, Dokumente, PDFs und weitere Dateiformate. Der Bereich befindet sich in der Sidebar unter Assets (\u002Fadmin\u002Fassets).",{"id":509,"title":510,"titles":511,"content":512,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fassets\u002Fupload#upload","Upload",[66],"Im oberen Bereich der Assets-Seite befindet sich die Upload-Zone: Drag & Drop – Ziehe Dateien direkt in die Upload-Zone.\"Choose Files\" Button – Öffnet den Dateidialog zur Auswahl.\"Upload Files\" Button – Startet den Upload der ausgewählten Dateien. Erlaubt sind gängige Dateiformate. Die maximale Dateigröße beträgt 100 MB pro Datei.",{"id":514,"title":515,"titles":516,"content":517,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fassets\u002Fupload#dateiliste","Dateiliste",[66],"Unterhalb der Upload-Zone werden alle hochgeladenen Assets in einer Tabelle angezeigt: SpalteBeschreibungPreviewVorschaubild der Datei (bei Bildern)LabelKlickbarer Dateiname \u002F AnzeigenameFilenameTechnischer DateinameKeyOptionaler eindeutiger SchlüsselStateStatus der Datei: Preview Synced, Vector Synced, Vector N\u002FATypeMIME-Type der Datei (z.B. image\u002Fpng)SizeDateigrößeCreatedErstellungsdatum und Uhrzeit",{"id":519,"title":520,"titles":521,"content":522,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fassets\u002Fupload#ordnerstruktur","Ordnerstruktur",[66],"Assets können in Ordnern organisiert werden. Über den \"New Folder\" Button oben rechts lassen sich neue Ordner erstellen. Die aktuelle Position wird in der Breadcrumb-Navigation (Path \u002F) angezeigt.",{"id":524,"title":525,"titles":526,"content":527,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fassets\u002Fupload#suche","Suche",[66],"Über die Suchleiste oben rechts können Assets nach Name durchsucht werden. Der Button \"Search Subfolders\" erweitert die Suche auf Unterordner.",{"id":529,"title":530,"titles":531,"content":532,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fassets\u002Fupload#sync-status","Sync-Status",[66],"Jedes Asset hat einen Synchronisationsstatus: StatusBedeutungPreview SyncedDie Vorschau wurde erfolgreich generiertVector SyncedDer Bildvektor wurde für die Bildsuche indexiertVector N\u002FAKeine Vektorisierung verfügbar (z.B. bei Nicht-Bild-Dateien) Die Bildvektorsuche kann unter Organization → DM Settings aktiviert oder deaktiviert werden.",{"id":534,"title":535,"titles":536,"content":537,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fassets\u002Fupload#asset-aktionen","Asset-Aktionen",[66],"Über das Drei-Punkte-Menü (⋮) am Ende jeder Zeile stehen weitere Aktionen zur Verfügung, z.B. Umbenennen, Verschieben oder Löschen.",{"id":81,"title":80,"titles":539,"content":540,"level":182},[],"Zugriffsstatistiken für deine Digitalen Produktpässe – Aufrufe, Sessions und Geräte. Das DPP Access-Dashboard zeigt Zugriffsstatistiken für deine veröffentlichten Produktpässe. Du siehst, wie oft und von welchen Geräten auf deine DPP-Seiten zugegriffen wurde. Erreichbar unter Dashboard → DPP Access (\u002Fadmin\u002Fdashboard\u002Faccess).",{"id":542,"title":543,"titles":544,"content":545,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fdpp-access#kennzahlen","Kennzahlen",[80],"Im oberen Bereich werden drei Kennzahlen als Karten angezeigt: KennzahlBeschreibungTotal CallsGesamtzahl aller Aufrufe im gewählten ZeitraumUnique EntitiesAnzahl unterschiedlicher Produktpässe, die aufgerufen wurdenSessionsAnzahl individueller Nutzersessions",{"id":547,"title":548,"titles":549,"content":550,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fdpp-access#zeitraumfilter","Zeitraumfilter",[80],"Über die Datumsauswahl oben links lässt sich der Auswertungszeitraum anpassen. Der Granularitätsfilter (z.B. „Daily\") steuert die Auflösung des Diagramms.",{"id":552,"title":553,"titles":554,"content":555,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fdpp-access#verlaufsdiagramm","Verlaufsdiagramm",[80],"Ein Liniendiagramm zeigt den zeitlichen Verlauf der Aufrufe. Die X-Achse zeigt den Zeitraum, die Y-Achse die Anzahl der Calls.",{"id":557,"title":558,"titles":559,"content":560,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fdpp-access#zugriffstabelle","Zugriffstabelle",[80],"Unterhalb des Diagramms listet eine Tabelle die einzelnen Zugriffe auf: SpalteBeschreibungLast HitZeitpunkt des letzten ZugriffsEntity KeyKey des aufgerufenen ProduktpassesCallsAnzahl der AufrufeDeviceGerätetyp (z.B. Desktop, Mobile)",{"id":86,"title":85,"titles":562,"content":563,"level":182},[],"Systemkennzahlen – Produktpässe, Assets und Speicherverbrauch auf einen Blick. Das Numbers-Dashboard bietet einen schnellen Überblick über die wichtigsten Systemkennzahlen deiner Organisation. Erreichbar unter Dashboard → Numbers (\u002Fadmin\u002Fdashboard\u002Fnumbers).",{"id":565,"title":543,"titles":566,"content":567,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fnumbers#kennzahlen",[85],"Im oberen Bereich werden vier Karten angezeigt: KennzahlBeschreibungTotal PassportsGesamtzahl aller Produktpässe in der OrganisationTotal AssetsAnzahl aller hochgeladenen MediendateienAssets by KindAufschlüsselung nach Dateityp (Dateien \u002F Ordner)Asset Storage UsedBelegter Speicherplatz für Assets",{"id":569,"title":570,"titles":571,"content":572,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdashboard\u002Fnumbers#passports-by-layer","Passports by Layer",[85],"Eine Tabelle zeigt die Verteilung der Produktpässe nach Layer: SpalteBeschreibungLayerName des Layers (z.B. „Artiekl\")KeyTechnischer Schlüssel des LayersPassportsAnzahl der Produktpässe in diesem Layer",{"id":96,"title":95,"titles":574,"content":575,"level":182},[],"Massenimport von Attribute Groups, Attribute Definitions und Entities per JSON-Datei. Der Import-Bereich ermöglicht den Massenimport von Daten in die DPP-Plattform. Alle Imports erfolgen über JSON-Dateien, die per Drag & Drop oder Dateiauswahl hochgeladen werden. Erreichbar unter Import in der Sidebar. Oben rechts auf jeder Import-Seite findest du die Buttons \"Schema\" und \"Example\" für die erwartete Datenstruktur.",{"id":577,"title":578,"titles":579,"content":340,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport#verfügbare-import-typen","Verfügbare Import-Typen",[95],{"id":581,"title":51,"titles":582,"content":583,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport#attribute-groups",[95,578],"URL: \u002Fadmin\u002Fimport\u002Fattribute-groups Importiert Attributgruppen per JSON. Nützlich, wenn du viele Gruppen auf einmal anlegen möchtest, z.B. beim initialen Setup einer neuen Organisation.",{"id":585,"title":56,"titles":586,"content":587,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport#attribute-definitions",[95,578],"URL: \u002Fadmin\u002Fimport\u002Fattribute-definitions Importiert Attributdefinitionen per JSON. Besonders hilfreich, wenn ein umfangreiches Datenmodell mit vielen Attributen aufgesetzt werden soll.",{"id":589,"title":590,"titles":591,"content":592,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport#entities","Entities",[95,578],"URL: \u002Fadmin\u002Fimport\u002Fentities Importiert Produktpässe (Entities) per JSON. Dies ist der häufigste Import-Typ und wird z.B. für den initialen Datenimport aus ERP-Systemen oder Produktdatenbanken verwendet.",{"id":594,"title":595,"titles":596,"content":597,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport#import-ablauf","Import-Ablauf",[95],"Navigiere zum gewünschten Import-Typ.Ziehe eine JSON-Datei in die Drop-Zone oder klicke auf \"Choose a JSON file to begin\".Klicke auf den grünen Import-Button (z.B. „Import Entities\").Der Import wird im Hintergrund verarbeitet. Der Fortschritt wird angezeigt.",{"id":599,"title":600,"titles":601,"content":602,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport#import-status","Import-Status",[95],"Vergangene Imports werden im Abschnitt \"Imports\" unterhalb der Upload-Zone als Karten dargestellt. Jede Karte zeigt: FeldBeschreibungDateinameName der importierten JSON-DateiIDEindeutige Import-IDStatusCompleted, Queued oder FailedBenutzerWer den Import durchgeführt hatBatchesAnzahl verarbeiteter BatchesTotal \u002F Created \u002F UpdatedStatistik der verarbeiteten DatensätzeErrorsAnzahl der FehlerStarted \u002F FinishedZeitstempel des ImportsTotal RuntimeGesamtlaufzeit des Imports Bei Fehlern wird ein \"Show errors\" Button angezeigt, der die Fehlermeldungen im Detail auflistet. Prüfe die Fehler und korrigiere die JSON-Datei entsprechend.",{"id":604,"title":605,"titles":606,"content":607,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fimport\u002Fimport#json-schema-beispieldateien","JSON-Schema & Beispieldateien",[95],"Auf jeder Import-Seite findest du oben rechts zwei Buttons: \"Schema\" – Zeigt das erwartete JSON-Schema für den jeweiligen Import-Typ.\"Example\" – Lädt eine Beispiel-JSON-Datei herunter, die als Vorlage dienen kann. Verwende immer zuerst die Example-Datei als Vorlage, um Formatierungsfehler zu vermeiden.",{"id":106,"title":105,"titles":609,"content":610,"level":182},[],"Allgemeine Organisationseinstellungen – Name, Kontaktdaten und Adresse. Unter Organization → General werden die grundlegenden Informationen deiner Organisation verwaltet. Erreichbar unter Organization → General (\u002Fadmin\u002Fsettings).",{"id":612,"title":377,"titles":613,"content":340,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fgeneral#felder",[105],{"id":615,"title":616,"titles":617,"content":618,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fgeneral#basic-information","Basic Information",[105,377],"FeldPflichtBeschreibungOrganization nameJaName deiner OrganisationPhoneJaTelefonnummerDescriptionNeinKurzbeschreibung der Organisation",{"id":620,"title":621,"titles":622,"content":623,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fgeneral#address","Address",[105,377],"FeldPflichtBeschreibungStreet + house numberJaStraße und HausnummerPostal codeJaPostleitzahlCityJaStadtState \u002F RegionNeinBundesland oder RegionCountryJaLand",{"id":625,"title":626,"titles":627,"content":628,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fgeneral#organization-id","Organization ID",[105,377],"Am unteren Rand der Seite wird die Organization ID angezeigt – eine eindeutige UUID, die deine Organisation identifiziert. Diese ID wird z.B. für die API-Konfiguration benötigt. Änderungen werden über den \"Save changes\" Button oben rechts gespeichert.",{"id":111,"title":110,"titles":630,"content":631,"level":182},[],"Datenmodell-Einstellungen – Key-Validierung, Bildvektorsuche und Suchindex-Verwaltung. Die DM Settings (Datamodel Settings) steuern technische Aspekte des Datenmodells und der Suchfunktionen. Erreichbar unter Organization → DM Settings (\u002Fadmin\u002Fsettings\u002Fdm-settings).",{"id":633,"title":634,"titles":635,"content":636,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fdm-settings#datamodel-settings","Datamodel Settings",[110],"EinstellungBeschreibungDisable entity key checkWenn aktiviert, werden Key und parentKey nicht auf URL-Sicherheit geprüft. Standardmäßig deaktiviert.Enable image vector searchSteuert die Bildvektorisierung, Reverse-Image-Search und den Image-Search-Index-Sync.",{"id":638,"title":639,"titles":640,"content":641,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fdm-settings#search-indexes","Search Indexes",[110],"Unterhalb der Einstellungen werden die Search Indexes angezeigt. Diese überwachen den Zustand der Suchindizes und ermöglichen Reparaturen.",{"id":643,"title":644,"titles":645,"content":646,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fdm-settings#search-index","Search Index",[110,639],"Dient der Volltextsuche über Produktpässe. FeldBeschreibungStatusHealthy oder UnhealthyStateIdle oder RunningCollectionName der MongoDB-CollectionIndex NameName des Atlas-SuchindexAtlas StatusREADY, PENDING oder FAILEDExists \u002F QueryableOb der Index existiert und abfragbar istDrift ReasonsAbweichungen zwischen erwartetem und aktuellem MusterExpected \u002F Current PatternZeigt die indexierten Felder",{"id":648,"title":649,"titles":650,"content":651,"level":346},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fdm-settings#image-search-index","Image Search Index",[110,639],"Dient der Bildsuche über vektorisierte Assets. Die Felder sind analog zum Search Index, zusätzlich mit: FeldBeschreibungVector PathPfad zum Embedding-FeldSimilarity \u002F DimensionsÄhnlichkeitsmetrik und Vektordimensionen Änderungen an den Search Indexes sollten nur von Administratoren vorgenommen werden. Bei Problemen hilft der Refresh-Button (🔄) neben dem Index.",{"id":116,"title":115,"titles":653,"content":654,"level":182},[],"Mitgliederverwaltung – Einladungen, Rollen und Zugriffsrechte. Unter Members verwaltest du die Mitglieder deiner Organisation und deren Zugriffsrechte. Erreichbar unter Organization → Members (\u002Fadmin\u002Fsettings\u002Fmembers).",{"id":656,"title":657,"titles":658,"content":659,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fmembers#mitglieder-einladen","Mitglieder einladen",[115],"Im oberen Bereich findest du das Einladungsformular: Gib die E-Mail-Adresse der Person ein.Wähle eine Rolle aus dem Dropdown (z.B. „Member\").Klicke auf \"Invite\". Die eingeladene Person erhält eine E-Mail mit einem Einladungslink.",{"id":661,"title":662,"titles":663,"content":664,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fmembers#rollen","Rollen",[115],"RolleBeschreibungOwnerVollzugriff – kann Organisation verwalten, Mitglieder einladen\u002Fentfernen und alle Daten bearbeitenMemberEingeschränkter Zugriff – kann Produktpässe und Assets bearbeiten, aber keine Organisationseinstellungen ändern",{"id":666,"title":667,"titles":668,"content":669,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fmembers#mitgliederliste","Mitgliederliste",[115],"Die aktuelle Mitgliederliste zeigt: FeldBeschreibungNameName des MitgliedsE-MailE-Mail-AdresseRolleAktuelle Rolle (Owner \u002F Member)AktionenRollen-Icon zum Ändern der Rolle oder Entfernen Das Entfernen eines Mitglieds kann nicht rückgängig gemacht werden. Die Person müsste erneut eingeladen werden.",{"id":121,"title":120,"titles":671,"content":672,"level":182},[],"Erstellung, Verwaltung und Best Practices für API-Zugriffsschlüssel der DPP-Plattform. Unter API Keys erstellst und verwaltest du Zugriffsschlüssel für die REST-API der DPP-Plattform. Diese Seite ist die\nzentrale Anlaufstelle für alles rund um API Keys – sowohl die UI-Bedienung als auch die Verwendung im HTTP-Request. Erreichbar unter Organization → API Keys (\u002Fadmin\u002Fsettings\u002Fapi-keys). Die Endpoint-Details für die Verwendung\nfindest du in der API-Referenz (Swagger).",{"id":674,"title":675,"titles":676,"content":677,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys#neuen-api-key-erstellen","Neuen API Key erstellen",[120],"Navigiere zu Organization → API Keys (\u002Fadmin\u002Fsettings\u002Fapi-keys).Trage im Erstellungsformular die folgenden Felder ein: FeldPflichtBeschreibungNameJaBeschreibender Name für den Key (z.B. „CI\u002FCD\", „ERP-Integration\")RoleJaZugriffsrolle: MEMBER oder OWNERExpires atNeinOptionales Ablaufdatum Klicke auf „Generate Key\" um den Schlüssel zu erstellen. Der vollständige API Key wird nur einmal beim Erstellen angezeigt. Kopiere ihn sofort und bewahre ihn sicher auf\n(z.B. im Secret Manager). Er kann nicht erneut abgerufen werden.",{"id":679,"title":680,"titles":681,"content":682,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys#rollen-berechtigungen","Rollen & Berechtigungen",[120],"RolleLesenSchreibenOrganisations­einstellungenMEMBER✓✓–OWNER✓✓✓ Welche Endpoints mit welcher Rolle erreichbar sind, ist in der\nSwagger-Referenz pro Endpoint dokumentiert.",{"id":684,"title":685,"titles":686,"content":687,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys#active-api-keys","Active API Keys",[120],"Aktive API Keys werden als Liste angezeigt mit: FeldBeschreibungNameDer vergebene NameIDEindeutige Key-IDPreviewErste Zeichen des Keys (maskiert)CreatedErstellungsdatumLast usedZeitpunkt der letzten NutzungStatusActive BadgeRoleZugewiesene Rolle Über das Drei-Punkte-Menü (⋮) kann ein Key deaktiviert oder gelöscht werden.",{"id":689,"title":690,"titles":691,"content":692,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys#inactive-api-keys","Inactive API Keys",[120],"Deaktivierte Keys werden im Abschnitt „Inactive API Keys\" angezeigt und akzeptieren keine API-Aufrufe mehr.\nGelöschte Keys verschwinden vollständig aus der Liste.",{"id":694,"title":695,"titles":696,"content":697,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys#verwendung-im-request","Verwendung im Request",[120],"API Keys werden im x-api-key-Header von HTTP-Requests übergeben. Alle Aufrufe gehen gegen: https:\u002F\u002Fmy.digital-product-passport.cloud Beispiel: x-api-key: \u003CAPI-KEY>\nContent-Type: application\u002Fjson Weitere Details zum Authentifizierungs-Konzept, Fehlercodes und Sicherheitshinweisen findest du unter\nAuthentication.",{"id":699,"title":700,"titles":701,"content":702,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys#best-practices","Best Practices",[120],"Separate Keys pro Integration – verwende für jede Anwendung einen eigenen Key.Minimale Berechtigung – vergib nur die notwendige Rolle (MEMBER statt OWNER, wenn möglich).Ablaufdatum setzen – speziell für temporäre Integrationen oder externe Dienstleister.Keys regelmäßig rotieren – neuen Key erstellen, Integration umstellen, alten Key deaktivieren.Niemals im Quellcode – Keys gehören in Umgebungsvariablen oder einen Secret Manager, nicht in Repositories oder\nFrontend-Bundles.Bei Verdacht auf Kompromittierung – betroffenen Key sofort deaktivieren und einen neuen ausstellen.",{"id":131,"title":130,"titles":704,"content":705,"level":182},[],"Konfiguration der Frontend-URL, Custom Domain und des Organisation-Slugs. Unter DPP Page → Domain verwaltest du die URL-Einstellungen für deine öffentliche DPP-Seite. Erreichbar unter DPP Page → Domain (\u002Fadmin\u002Fdpp\u002Fdomain). Das Ändern des Slugs oder der Custom Domain macht bestehende QR-Codes und Links ungültig!",{"id":707,"title":708,"titles":709,"content":710,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fdomain#einstellungen","Einstellungen",[130],"FeldBeschreibungFrontend URLDie aktuelle URL deiner öffentlichen DPP-Seite. Standardformat: https:\u002F\u002F\u003Cslug>.dpp-portal.io\u002Fdpp\u002F\u003Centity-key>Custom DomainOptionale eigene Domain für das DPP-Frontend (z.B. dpp.example.com)Organization SlugWird für den Aufbau der Subdomain verwendet. Nur Kleinbuchstaben, Zahlen und Bindestriche erlaubt. Über den \"Open (default)\" Button neben der Frontend URL kannst du die öffentliche Seite direkt im Browser öffnen.",{"id":136,"title":135,"titles":712,"content":713,"level":182},[],"Visuelles Erscheinungsbild der öffentlichen DPP-Seite – Logo, Farben, Schrift und UI. Unter DPP Page → Design passt du das visuelle Erscheinungsbild deiner öffentlichen Produktpass-Seite an. Erreichbar unter DPP Page → Design (\u002Fadmin\u002Fdpp\u002Fdesign).",{"id":715,"title":708,"titles":716,"content":717,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fdesign#einstellungen",[135],"FeldBeschreibungLogoDas Logo, das auf der DPP-Frontend-Seite angezeigt wird. Upload per Klick auf das Upload-Icon.Primary ColorHauptfarbe für Überschriften (Hex-Wert, z.B. #027617)Secondary ColorAkzentfarbe für weitere Elemente (z.B. #008746)Text ColorFarbe für Fließtext (z.B. #c4c4c4)Button ColorFarbe für Buttons und Bildrahmen (z.B. #000000)QR-Code ColorFarbe des generierten QR-Codes (z.B. #000000)UI RadiusEckenradius für Buttons und Bilder (in rem, z.B. 0.65)FontSchriftart für die DPP-Seite. Über „Browse Fonts\" durchsuchbar.TitleÜberschrift neben dem Logo auf der DPP-Seite (z.B. „Product Passport\") Über den \"Example\" Button neben dem UI Radius kannst du eine Vorschau der aktuellen Einstellungen sehen. Änderungen werden über den \"Save changes\" Button oben rechts gespeichert.",{"id":141,"title":140,"titles":719,"content":720,"level":182},[],"Anpassbare Texte der öffentlichen DPP-Seite – Buttons, Labels und Platzhalter. Unter DPP Page → UI Translations verwaltest du die anpassbaren Texte, die auf der öffentlichen DPP-Seite angezeigt werden. Erreichbar unter DPP Page → UI Translations (\u002Fadmin\u002Fdpp\u002Ftranslations).",{"id":722,"title":468,"titles":723,"content":724,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fui-translations#übersicht",[140],"Die Tabelle zeigt alle anpassbaren Textelemente: SpalteBeschreibungScopeBereich der DPP-Seite (z.B. dpp_footer, dpp_page, dpp_search)KeyTechnischer Schlüssel des TextesDescriptionErklärung, wo der Text erscheintDefaultAktueller Standardtext",{"id":726,"title":727,"titles":728,"content":729,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fui-translations#verfügbare-texte","Verfügbare Texte",[140],"ScopeKeyBeschreibungDefaultdpp_footerimpressumLabel für den Impressum-Link im FooterImpressumdpp_pageallLabel im Layer-Filter für „Alle\"Alldpp_pageattributes_collapseButton zum Zuklappen aller AttributgruppenCollapse attributesdpp_pageattributes_expandButton zum Aufklappen aller AttributgruppenExpand attributesdpp_pageopenLabel für Aktionen zum Öffnen verlinkter InhalteOpendpp_pagedownloadLabel für Aktionen zum Herunterladen verlinkter InhalteDownloaddpp_pageimageLabel für bildbezogene verlinkte InhalteImagedpp_pageshow_qr_codeButton zum Anzeigen des QR-CodesShow QR codedpp_pagehide_qr_codeButton zum Ausblenden des QR-CodesHide QR codedpp_pagecopy_linkButton zum Kopieren des öffentlichen DPP-LinksCopy linkdpp_pagedownload_qr_codeButton zum Herunterladen des QR-CodesDownload QR codedpp_pagecopiedKurzzeitiger Erfolgstext nach dem Kopieren des LinksCopieddpp_pagesearch_linkText des Links zur SucheGo To Searchdpp_searchno_resultsText wenn keine Ergebnisse gefunden werdenNo results founddpp_searchsearch_placeholderPlatzhalter in der SuchleisteEnter Article Number or Serial Codedpp_searchsubtitleUntertitel der SuchseiteSearch you Productdpp_searchtitleTitel der SuchseiteDigital Product Passport Um einen Text zu bearbeiten, klicke auf das Edit-Icon (Stift) in der jeweiligen Zeile.",{"id":145,"title":144,"titles":731,"content":732,"level":182},[],"Pflege des rechtlichen Impressums für die öffentliche DPP-Seite. Unter DPP Page → Impressum verwaltest du den Impressumstext, der auf deiner öffentlichen DPP-Seite im Footer verlinkt wird. Erreichbar unter DPP Page → Impressum (\u002Fadmin\u002Fdpp\u002Fimpressum).",{"id":734,"title":735,"titles":736,"content":737,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fimpressum#bearbeitung","Bearbeitung",[144],"Das Impressum wird über einen Rich-Text-Editor bearbeitet. Verfügbare Formatierungsoptionen: H – Überschriften≡ – AufzählungslistenB \u002F I \u002F U \u002F S – Fett, Kursiv, Unterstrichen, Durchgestrichen≡ – Einrückung",{"id":739,"title":740,"titles":741,"content":742,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002Fimpressum#mehrsprachigkeit","Mehrsprachigkeit",[144],"Über den Sprachfilter oben rechts (z.B. „DE (deutsch)\") kann das Impressum pro Sprache gepflegt werden. Falls eine Sprache leer ist, fällt die DPP-Seite automatisch auf die Standardsprache zurück. Ein Impressum ist für viele Länder (z.B. Deutschland, Österreich) gesetzlich vorgeschrieben. Stelle sicher, dass alle Pflichtangaben enthalten sind.",{"id":150,"title":149,"titles":744,"content":745,"level":182},[],"Anpassung der Fehlerseite für nicht gefundene Produktpässe. Unter DPP Page → 404 Page konfigurierst du den Text, der angezeigt wird, wenn ein Nutzer einen ungültigen oder nicht existierenden Produktpass-Link aufruft. Erreichbar unter DPP Page → 404 Page (\u002Fadmin\u002Fdpp\u002F404).",{"id":747,"title":735,"titles":748,"content":749,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002F404-page#bearbeitung",[149],"Der 404-Seitentext wird über denselben Rich-Text-Editor bearbeitet wie das Impressum. Verfügbare Formatierungsoptionen: Überschriften, Listen, Fett, Kursiv, Unterstrichen, Durchgestrichen und Einrückung.",{"id":751,"title":740,"titles":752,"content":753,"level":188},"\u002Fdocs\u002Fproduktdokumentation\u002Fdpp-page\u002F404-page#mehrsprachigkeit",[149],"Über den Sprachfilter oben rechts kann der 404-Text pro Sprache gepflegt werden. Falls eine Sprache leer ist, wird automatisch die Standardsprache verwendet. Änderungen werden über den \"Save changes\" Button oben rechts gespeichert.",{"id":160,"title":159,"titles":755,"content":756,"level":182},[],"Einführung in die REST-API der Contsult DPP-Plattform – mit direktem Link zur interaktiven API-Referenz. Die Contsult DPP-Plattform bietet eine REST-API für den programmatischen Zugriff auf Produktpässe, Attribute und\nAssets. Die API folgt dem API-First-Prinzip – alle Funktionen, die über die Admin-Oberfläche verfügbar sind, können auch\nüber die API gesteuert werden. Vollständige API-Referenz\nDie interaktive Swagger-Doku mit allen Endpoints, Request-\u002FResponse-Schemata und einer „Try it out\"-Funktion findest du\nunter my.digital-product-passport.cloud\u002Fapi-docs.\nDu musst dafür in der DPP-Plattform eingeloggt sein.",{"id":758,"title":759,"titles":760,"content":761,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fgeneral#was-findest-du-wo","Was findest du wo?",[159],"InhaltOrtAlle Endpoints, Parameter, Request-\u002FResponse-BodyAPI-Referenz (Swagger)API Keys anlegen, verwalten & Best PracticesOrganization → API KeysAuthentifizierungs-Konzept & SicherheitshinweiseAuthentication",{"id":763,"title":764,"titles":765,"content":766,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fgeneral#grundprinzipien","Grundprinzipien",[159],"REST über HTTPS – JSON für Requests und Responses.Server – alle Aufrufe gehen gegen https:\u002F\u002Fmy.digital-product-passport.cloud.API-Key-Header – jeder Aufruf benötigt einen gültigen API Key im x-api-key-Header.API-First – die UI nutzt dieselben Endpoints wie externe Integrationen. Versionierung, Rate-Limit-Header und alle weiteren technischen Details sind in der Swagger-Doku dokumentiert und werden\ndort aktuell gehalten.",{"id":768,"title":769,"titles":770,"content":771,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fgeneral#erste-schritte","Erste Schritte",[159],"API Key erstellen – siehe Organization → API Keys.Authentifizierung verstehen – siehe Authentication.Endpoints erkunden – direkt in der\nSwagger-Referenz inklusive „Try it out\".",{"id":773,"title":774,"titles":775,"content":776,"level":182},"\u002Fdocs\u002Fapi-and-developer\u002Faccess-key-management","Access Key Management",[],"Diese Seite wurde in „Organization → API Keys\" zusammengeführt. Der Inhalt dieser Seite ist in Organization → API Keys\nzusammengeführt. Dort findest du: UI-Walkthrough zum Anlegen, Deaktivieren und Löschen von KeysRollen und BerechtigungenVerwendung im x-api-key-HeaderBest Practices für die sichere Aufbewahrung und Rotation Aktualisiere deine Lesezeichen auf\n\u002Fdocs\u002Fproduktdokumentation\u002Forganization\u002Fapi-keys.",{"id":165,"title":164,"titles":778,"content":779,"level":182},[],"Authentifizierungs-Konzept der DPP-API – API-Key-Header, Fehlercodes und Sicherheitshinweise. Die DPP-API verwendet API-Key-Authentifizierung über einen eigenen Request-Header. Jeder API-Aufruf muss einen\ngültigen API Key im x-api-key-Header enthalten. Endpoint-Details, Beispiel-Requests und „Try it out\" findest du in der interaktiven\nAPI-Referenz (Swagger). Diese Seite beschreibt das\nKonzept und die Sicherheitsanforderungen – nicht die einzelnen Endpoints.",{"id":781,"title":782,"titles":783,"content":784,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fauthentication#server","Server",[164],"Alle API-Aufrufe gehen gegen: https:\u002F\u002Fmy.digital-product-passport.cloud",{"id":786,"title":787,"titles":788,"content":789,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fauthentication#request-header","Request-Header",[164],"Jeder Request übergibt den API Key im x-api-key-Header: x-api-key: \u003CAPI-KEY>\nContent-Type: application\u002Fjson Beispiel mit cURL: curl -X GET \\\n  https:\u002F\u002Fmy.digital-product-passport.cloud\u002F\u003Cendpoint> \\\n  -H \"x-api-key: \u003CAPI-KEY>\" \\\n  -H \"Content-Type: application\u002Fjson\" API Keys werden über die Admin-Oberfläche unter\nOrganization → API Keys erstellt und verwaltet.",{"id":791,"title":792,"titles":793,"content":794,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fauthentication#typische-fehlercodes","Typische Fehlercodes",[164],"HTTP StatusBedeutung401 UnauthorizedKein x-api-key gesetzt, Key ungültig, abgelaufen oder gesperrt403 ForbiddenAPI Key hat nicht die erforderliche Rolle für den Endpoint429 Too Many RequestsRate Limit überschritten Die konkreten Response-Schemata pro Endpoint findest du in der\nSwagger-Referenz.",{"id":796,"title":797,"titles":798,"content":799,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fauthentication#sicherheitshinweise","Sicherheitshinweise",[164],"Übertrage API Keys ausschließlich über HTTPS.Verwende API Keys nie im Frontend-Code oder in öffentlichen Repositories – sie sind serverseitige Credentials.Speichere Keys in Umgebungsvariablen oder einem Secret Manager (z.B. Azure Key Vault, AWS Secrets Manager,\nHashiCorp Vault, 1Password Secrets).Pro Integration ein eigener Key – das erleichtert das Rotieren und die Nachvollziehbarkeit in den Audit-Logs.Bei Verdacht auf Kompromittierung: Key sofort über die Admin-Oberfläche deaktivieren und einen neuen ausstellen.",{"id":801,"title":802,"titles":803,"content":804,"level":188},"\u002Fdocs\u002Fapi-and-developer\u002Fauthentication#weiterführend","Weiterführend",[164],"Organization → API Keys – Keys anlegen, rotieren und löschenAPI-Referenz (Swagger) – alle Endpoints,\nParameter und Response-Schemata html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"id":175,"title":174,"titles":806,"content":807,"level":182},[],"Schritt-für-Schritt-Anleitung – vom leeren System zum ersten veröffentlichten Digitalen Produktpass. Diese Anleitung führt dich durch den kompletten Prozess – von der Ersteinrichtung des Datenmodells bis zum fertigen, öffentlich zugänglichen Produktpass.",{"id":809,"title":343,"titles":810,"content":811,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#voraussetzungen",[174],"Zugang zur DPP-Plattform mit Owner-RechtenEine angelegte Organisation inkl. gepflegter Stamm- und Adressdaten (siehe Organization → General)Mindestens ein Produkt, das dokumentiert werden soll Tipp für große Datenmengen: Viele Schritte des Datenmodells (Attribute Groups, Attribute Definitions) sowie die Produktpässe selbst können auch per JSON-Massenimport oder über die REST-API angelegt werden – ideal für die initiale Befüllung oder den Import aus ERP-\u002FPIM-Systemen. Details findest du unter Datenimport und in der API-Übersicht.",{"id":813,"title":814,"titles":815,"content":816,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-1-sprache-anlegen","Schritt 1: Sprache anlegen",[174],"Navigiere zu Data Model → Languages und lege mindestens eine Sprache an. Klicke auf \"+ New\"Vergib Key und ISO Code (z.B. de \u002F German (de))Setze Short name (z.B. DE) und Long name (z.B. deutsch)Aktiviere Is DefaultKlicke auf Save",{"id":818,"title":819,"titles":820,"content":821,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-2-attributgruppen-erstellen","Schritt 2: Attributgruppen erstellen",[174],"Navigiere zu Data Model → Attribute Groups und erstelle die gewünschten Gruppen. Typische Gruppen für einen Produktpass: GruppeKeyZweckStammdatenDPP_StammdatenGrundlegende ProduktinformationenTechnische AttributeDPP_Technische_AttributeMaße, Gewichte, technische DatenBilderDPP_BilderProduktfotos und GrafikenDokumenteDPP_DokumentePDFs, Datenblätter, Zertifikate",{"id":823,"title":824,"titles":825,"content":826,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-3-attributdefinitionen-anlegen","Schritt 3: Attributdefinitionen anlegen",[174],"Navigiere zu Data Model → Attribute Definitions und definiere die Datenfelder. Beispiele: AttributKeyTypGruppeArtikelnummerATTRIBUT_ArtikelnummerTextStammdatenGTINATTRIBUT_GTINTextStammdatenGewichtATTRIBUT_GewichtNumberTechnische AttributeProduktbildATTRIBUT_ProduktbildImageBilderDatenblattATTRIBUT_DatenblattDocumentDokumente Setze bei der Artikelnummer Unique und Searchable auf „Ja\", damit sie als eindeutiger Identifikator dient.",{"id":828,"title":829,"titles":830,"content":831,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-4-layer-definieren","Schritt 4: Layer definieren",[174],"Navigiere zu Data Model → Layers und erstelle mindestens einen Layer. Klicke auf \"+ Add Layer\"Vergib Key (z.B. Article), Icon und FarbePflege das Label pro SpracheKlicke auf Update",{"id":833,"title":834,"titles":835,"content":836,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-5-produktpass-anlegen","Schritt 5: Produktpass anlegen",[174],"Navigiere zu Product Passports und erstelle deinen ersten Eintrag. Klicke auf \"+ New\"Vergib einen Key (z.B. PRD-mein-produkt-001)Wähle den Layer (z.B. „Artikel\")Pflege die Entity Labels (z.B. DE: „Mein erstes Produkt\")Wechsle in die Tabs und füge über \"+ Add attribute\" Attribute hinzuFülle die Attributwerte ausKlicke auf Save",{"id":838,"title":839,"titles":840,"content":841,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-6-assets-hochladen","Schritt 6: Assets hochladen",[174],"Navigiere zu Assets und lade die benötigten Mediendateien hoch. Ziehe Bilder oder Dokumente in die Upload-ZoneKlicke auf \"Upload Files\"Gehe zurück zum Produktpass und verknüpfe die Assets mit den entsprechenden Bild- oder Dokumentattributen",{"id":843,"title":844,"titles":845,"content":846,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-7-dpp-seite-konfigurieren","Schritt 7: DPP-Seite konfigurieren",[174],"Navigiere zu DPP Page und passe das Erscheinungsbild an: Domain – Prüfe die Frontend-URL und den SlugDesign – Lade dein Logo hoch und passe Farben und Schrift anUI Translations – Übersetze die Texte der öffentlichen SeiteImpressum – Pflege die Pflichtangaben",{"id":848,"title":849,"titles":850,"content":851,"level":188},"\u002Fdocs\u002Fguides\u002Feinstiegs-guide-zum-ersten-dpp#schritt-8-ergebnis-prüfen","Schritt 8: Ergebnis prüfen",[174],"Navigiere zu Product PassportsKlicke auf das Drei-Punkte-Menü (⋮) neben deinem ProduktpassWähle \"View DPP Page\"Prüfe die öffentliche Seite auf Vollständigkeit und Darstellung Die URL der öffentlichen DPP-Seite kann als QR-Code gedruckt und auf dem physischen Produkt angebracht werden.",{"id":853,"title":120,"body":854,"description":1254,"extension":1255,"meta":1256,"navigation":1257,"path":121,"seo":1258,"stem":122,"__hash__":1259},"docs\u002F1.docs\u002F2.Produktdokumentation\u002F6.Organization\u002F4.API Keys.md",{"type":855,"value":856,"toc":1246},"minimark",[857,869,892,899,903,918,986,995,1005,1008,1055,1063,1066,1069,1152,1155,1158,1165,1168,1175,1184,1187,1193,1198,1201],[858,859,860,861,864,865,868],"p",{},"Unter ",[862,863,120],"strong",{}," erstellst und verwaltest du Zugriffsschlüssel für die REST-API der DPP-Plattform. Diese Seite ist die\n",[862,866,867],{},"zentrale Anlaufstelle"," für alles rund um API Keys – sowohl die UI-Bedienung als auch die Verwendung im HTTP-Request.",[870,871,872],"tip",{},[858,873,874,875,878,879,883,884,891],{},"Erreichbar unter ",[862,876,877],{},"Organization → API Keys"," (",[880,881,882],"code",{},"\u002Fadmin\u002Fsettings\u002Fapi-keys","). Die Endpoint-Details für die Verwendung\nfindest du in der ",[885,886,890],"a",{"href":887,"rel":888},"https:\u002F\u002Fmy.digital-product-passport.cloud\u002Fapi-docs#tag\u002Foverview",[889],"nofollow","API-Referenz (Swagger)",".",[858,893,894],{},[895,896],"img",{"alt":897,"src":898},"API-Keys-Seite mit Erstellungsformular sowie Listen für Active und Inactive API Keys","\u002Fimages\u002Fdocs\u002Forganization\u002Forganization-api-keys.png",[900,901,675],"h2",{"id":902},"neuen-api-key-erstellen",[904,905,906,915],"ol",{},[907,908,909,910,878,912,914],"li",{},"Navigiere zu ",[862,911,877],{},[880,913,882],{},").",[907,916,917],{},"Trage im Erstellungsformular die folgenden Felder ein:",[919,920,921,937],"table",{},[922,923,924],"thead",{},[925,926,927,931,934],"tr",{},[928,929,930],"th",{},"Feld",[928,932,933],{},"Pflicht",[928,935,936],{},"Beschreibung",[938,939,940,954,973],"tbody",{},[925,941,942,948,951],{},[943,944,945],"td",{},[862,946,947],{},"Name",[943,949,950],{},"Ja",[943,952,953],{},"Beschreibender Name für den Key (z.B. „CI\u002FCD\", „ERP-Integration\")",[925,955,956,961,963],{},[943,957,958],{},[862,959,960],{},"Role",[943,962,950],{},[943,964,965,966,969,970],{},"Zugriffsrolle: ",[880,967,968],{},"MEMBER"," oder ",[880,971,972],{},"OWNER",[925,974,975,980,983],{},[943,976,977],{},[862,978,979],{},"Expires at",[943,981,982],{},"Nein",[943,984,985],{},"Optionales Ablaufdatum",[904,987,988],{"start":346},[907,989,990,991,994],{},"Klicke auf ",[862,992,993],{},"„Generate Key\""," um den Schlüssel zu erstellen.",[996,997,998],"warning",{},[858,999,1000,1001,1004],{},"Der vollständige API Key wird ",[862,1002,1003],{},"nur einmal"," beim Erstellen angezeigt. Kopiere ihn sofort und bewahre ihn sicher auf\n(z.B. im Secret Manager). Er kann nicht erneut abgerufen werden.",[900,1006,680],{"id":1007},"rollen-berechtigungen",[919,1009,1010,1027],{},[922,1011,1012],{},[925,1013,1014,1017,1021,1024],{},[928,1015,1016],{},"Rolle",[928,1018,1020],{"align":1019},"center","Lesen",[928,1022,1023],{"align":1019},"Schreiben",[928,1025,1026],{"align":1019},"Organisations­einstellungen",[938,1028,1029,1043],{},[925,1030,1031,1035,1038,1040],{},[943,1032,1033],{},[880,1034,968],{},[943,1036,1037],{"align":1019},"✓",[943,1039,1037],{"align":1019},[943,1041,1042],{"align":1019},"–",[925,1044,1045,1049,1051,1053],{},[943,1046,1047],{},[880,1048,972],{},[943,1050,1037],{"align":1019},[943,1052,1037],{"align":1019},[943,1054,1037],{"align":1019},[858,1056,1057,1058,1062],{},"Welche Endpoints mit welcher Rolle erreichbar sind, ist in der\n",[885,1059,1061],{"href":887,"rel":1060},[889],"Swagger-Referenz"," pro Endpoint dokumentiert.",[900,1064,685],{"id":1065},"active-api-keys",[858,1067,1068],{},"Aktive API Keys werden als Liste angezeigt mit:",[919,1070,1071,1079],{},[922,1072,1073],{},[925,1074,1075,1077],{},[928,1076,930],{},[928,1078,936],{},[938,1080,1081,1090,1100,1110,1120,1130,1143],{},[925,1082,1083,1087],{},[943,1084,1085],{},[862,1086,947],{},[943,1088,1089],{},"Der vergebene Name",[925,1091,1092,1097],{},[943,1093,1094],{},[862,1095,1096],{},"ID",[943,1098,1099],{},"Eindeutige Key-ID",[925,1101,1102,1107],{},[943,1103,1104],{},[862,1105,1106],{},"Preview",[943,1108,1109],{},"Erste Zeichen des Keys (maskiert)",[925,1111,1112,1117],{},[943,1113,1114],{},[862,1115,1116],{},"Created",[943,1118,1119],{},"Erstellungsdatum",[925,1121,1122,1127],{},[943,1123,1124],{},[862,1125,1126],{},"Last used",[943,1128,1129],{},"Zeitpunkt der letzten Nutzung",[925,1131,1132,1137],{},[943,1133,1134],{},[862,1135,1136],{},"Status",[943,1138,1139,1142],{},[880,1140,1141],{},"Active"," Badge",[925,1144,1145,1149],{},[943,1146,1147],{},[862,1148,960],{},[943,1150,1151],{},"Zugewiesene Rolle",[858,1153,1154],{},"Über das Drei-Punkte-Menü (⋮) kann ein Key deaktiviert oder gelöscht werden.",[900,1156,690],{"id":1157},"inactive-api-keys",[858,1159,1160,1161,1164],{},"Deaktivierte Keys werden im Abschnitt ",[862,1162,1163],{},"„Inactive API Keys\""," angezeigt und akzeptieren keine API-Aufrufe mehr.\nGelöschte Keys verschwinden vollständig aus der Liste.",[900,1166,695],{"id":1167},"verwendung-im-request",[858,1169,1170,1171,1174],{},"API Keys werden im ",[880,1172,1173],{},"x-api-key","-Header von HTTP-Requests übergeben. Alle Aufrufe gehen gegen:",[1176,1177,1182],"pre",{"className":1178,"code":1180,"language":1181},[1179],"language-text","https:\u002F\u002Fmy.digital-product-passport.cloud\n","text",[880,1183,1180],{"__ignoreMap":340},[858,1185,1186],{},"Beispiel:",[1176,1188,1191],{"className":1189,"code":1190,"language":1181},[1179],"x-api-key: \u003CAPI-KEY>\nContent-Type: application\u002Fjson\n",[880,1192,1190],{"__ignoreMap":340},[858,1194,1195,1196,891],{},"Weitere Details zum Authentifizierungs-Konzept, Fehlercodes und Sicherheitshinweisen findest du unter\n",[885,1197,164],{"href":165},[900,1199,700],{"id":1200},"best-practices",[1202,1203,1204,1210,1222,1228,1234,1240],"ul",{},[907,1205,1206,1209],{},[862,1207,1208],{},"Separate Keys pro Integration"," – verwende für jede Anwendung einen eigenen Key.",[907,1211,1212,1215,1216,1218,1219,1221],{},[862,1213,1214],{},"Minimale Berechtigung"," – vergib nur die notwendige Rolle (",[880,1217,968],{}," statt ",[880,1220,972],{},", wenn möglich).",[907,1223,1224,1227],{},[862,1225,1226],{},"Ablaufdatum setzen"," – speziell für temporäre Integrationen oder externe Dienstleister.",[907,1229,1230,1233],{},[862,1231,1232],{},"Keys regelmäßig rotieren"," – neuen Key erstellen, Integration umstellen, alten Key deaktivieren.",[907,1235,1236,1239],{},[862,1237,1238],{},"Niemals im Quellcode"," – Keys gehören in Umgebungsvariablen oder einen Secret Manager, nicht in Repositories oder\nFrontend-Bundles.",[907,1241,1242,1245],{},[862,1243,1244],{},"Bei Verdacht auf Kompromittierung"," – betroffenen Key sofort deaktivieren und einen neuen ausstellen.",{"title":340,"searchDepth":188,"depth":188,"links":1247},[1248,1249,1250,1251,1252,1253],{"id":902,"depth":188,"text":675},{"id":1007,"depth":188,"text":680},{"id":1065,"depth":188,"text":685},{"id":1157,"depth":188,"text":690},{"id":1167,"depth":188,"text":695},{"id":1200,"depth":188,"text":700},"Erstellung, Verwaltung und Best Practices für API-Zugriffsschlüssel der DPP-Plattform.","md",{},{"icon":123},{"title":120,"description":1254},"tlIkxts0n2sEl5iX_9BygwIDSdDwyyzoj88sxbcMI54",[1261,1263],{"title":115,"path":116,"stem":117,"description":1262,"icon":118,"children":-1},"Mitgliederverwaltung – Einladungen, Rollen und Zugriffsrechte.",{"title":130,"path":131,"stem":132,"description":1264,"icon":133,"children":-1},"Konfiguration der Frontend-URL, Custom Domain und des Organisation-Slugs.",1778593611225]