{"openapi":"3.0.3","info":{"title":"Materivo Public API","description":"Kostenlose API für indexbasierte Kunststoff-Preisindikationen (alle 5 Minuten neu berechnet, in EUR/t), CO₂-Rechner und Material-Datenbank.","version":"1.0.0","contact":{"name":"Materivo API Support","url":"https://materivo.com","email":"api@materivo.com"},"license":{"name":"Kostenlos — ohne Schlüssel 50 Anfragen/Stunde je IP, mit Schlüssel 500/Stunde","url":"https://materivo.com/public-api"},"x-logo":{"url":"https://materivo.com/logo.png"}},"servers":[{"url":"https://www.materivo.com","description":"Production"}],"paths":{"/api/public/v1/preisindex":{"get":{"summary":"Kunststoff-Preisindex","description":"Indexbasierte Preisindikationen (berechnet, kein Börsenkurs) für 350 Kunststoff-Granulate und Rezyklate in EUR/t.","tags":["Preisindex"],"parameters":[{"name":"material","in":"query","schema":{"type":"string"},"description":"Komma-getrennte Materialcodes (z.B. PP,PE-HD,rPET)","example":"PP,PE-HD,rPET"},{"name":"category","in":"query","schema":{"type":"string","enum":["standard","technical","high-performance","recycled"]}},{"name":"format","in":"query","schema":{"type":"string","enum":["compact","detailed"]},"description":"compact gibt nur Material→Preis zurück"}],"responses":{"200":{"description":"Preisindex erfolgreich abgerufen"},"429":{"description":"Rate limit exceeded"}}}},"/api/public/v1/preisindex/{material}":{"get":{"summary":"Materialpreis Detail","description":"Detaillierte Preisdaten für ein einzelnes Material inkl. CO₂-Vergleich.","tags":["Preisindex"],"parameters":[{"name":"material","in":"path","required":true,"schema":{"type":"string"},"example":"PP"}],"responses":{"200":{"description":"Materialpreis erfolgreich abgerufen"},"404":{"description":"Material nicht gefunden"}}}},"/api/public/v1/co2-rechner":{"get":{"summary":"CO₂-Einsparungsrechner","description":"Berechnet CO₂-Einsparung durch Einsatz von Rezyklat statt Neuware. Ideal für ESG-Reporting.","tags":["CO₂-Rechner"],"parameters":[{"name":"material","in":"query","required":true,"schema":{"type":"string"},"description":"Kunststofftyp (z.B. PP, PE-HD, PET)","example":"PP"},{"name":"menge","in":"query","required":true,"schema":{"type":"number"},"description":"Menge in Kilogramm","example":1000},{"name":"rezyklat_anteil","in":"query","schema":{"type":"number","default":100},"description":"Rezyklat-Anteil in Prozent (0-100)"}],"responses":{"200":{"description":"CO₂-Berechnung erfolgreich"},"400":{"description":"Fehlende oder ungültige Parameter"},"404":{"description":"Material nicht in CO₂-Datenbank"}}}},"/api/public/v1/co2-rechner/materialien":{"get":{"summary":"CO₂-Faktoren aller Materialien","description":"Liste aller verfügbaren Materialien mit Virgin vs. Rezyklat CO₂-Faktoren.","tags":["CO₂-Rechner"],"responses":{"200":{"description":"Materialliste erfolgreich abgerufen"}}}},"/api/public/v1/materialien":{"get":{"summary":"Material-Datenbank","description":"Technische Daten zu Kunststoffen: Dichte, MFI, Schmelzpunkt, Zugfestigkeit etc.","tags":["Material-Datenbank"],"parameters":[{"name":"search","in":"query","schema":{"type":"string"},"description":"Suche nach Name oder Anwendung"},{"name":"recyclable","in":"query","schema":{"type":"boolean"}},{"name":"food_contact","in":"query","schema":{"type":"boolean"}},{"name":"category","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Materialliste erfolgreich abgerufen"}}}},"/api/public/v1/materialien/{code}":{"get":{"summary":"Material-Detailinfo","description":"Vollständige technische Daten zu einem spezifischen Kunststoff inkl. Preis und CO₂-Daten.","tags":["Material-Datenbank"],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"PP"}],"responses":{"200":{"description":"Material-Daten erfolgreich abgerufen"},"404":{"description":"Material nicht in Datenbank"}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Optional. Ohne Schlüssel: 50 Anfragen/Stunde je IP. Mit Schlüssel: 500/Stunde (10.000/Stunde bei Tarifen mit API-Stufe premium)."}}},"security":[{},{"ApiKey":[]}],"tags":[{"name":"Preisindex","description":"Indexbasierte Preisindikationen für 350 Kunststoff-Typen, alle 5 Minuten neu berechnet"},{"name":"CO₂-Rechner","description":"CO₂-Einsparung berechnen — ideal für ESG-Reporting"},{"name":"Material-Datenbank","description":"Technische Daten, Eigenschaften und Anwendungen"}],"externalDocs":{"description":"Vollständige Dokumentation auf materivo.com","url":"https://materivo.com/public-api"}}