Embed & API

Ein globales Skript aktiviert sowohl den harmonisierten Hinweis zur gesetzlichen Gewährleistung als auch automatische GARAN-Badges. Kostenlos, ohne Cookies, ohne Tracking, ohne externe Abhängigkeiten und ausfallsicher: Ist unsere API nicht erreichbar, bleibt Ihr Shop unbeeinträchtigt.

1. Skript installieren (einmalig, für die ganze Website)

2. Link zum Hinweis zur gesetzlichen Gewährleistung

Fügen Sie irgendwo einen Link ein (Header, Footer, Produktseite, Checkout). Beim Klick öffnet sich der offizielle harmonisierte Hinweis in einem barrierefreien Modal – in der Sprache der Seite (<html lang>) oder des data-lang-Attributs.

<a href="#garantieEu">Ihre gesetzlichen Gewährleistungsrechte</a>  <a href="#garantieEu" data-lang="ro">Drepturile tale privind garanția legală</a>

Ebenfalls unterstützt: class="garan-notice-link" an beliebigen Elementen sowie das automatische Einfügen in die CSS-Selektoren, die Sie in Ihrem kostenlosen Konto konfigurieren (Farben, Schrift, Hintergrund, Rahmen und Symbol sind pro Website anpassbar).

3. GARAN-Badge auf Produktseiten

Automatische Abfrage: Testphase. Die automatische Erkennung befindet sich noch in der Testphase. Das Badge erscheint nur, wenn für genau dieses Produkt eine Garantie in der GARAN-Datenbank registriert und verifiziert ist (Ihre Garantien oder die öffentlichen Labels); andernfalls wird nichts angezeigt. Prüfen Sie es auf einer Ihrer Produktseiten, bevor Sie es überall einsetzen, und helfen Sie mit, indem Sie Ihre Labels im öffentlichen Verzeichnis veröffentlichen. Für ein heute verlässliches Ergebnis nutzen Sie den Direktmodus unten (data-years).

Platzieren Sie ein leeres Element mit den Produktdaten. Existiert in der GARAN-Datenbank eine verifizierte gewerbliche Haltbarkeitsgarantie, wird das Nested-Label angezeigt; das vollständige Label öffnet sich beim ersten Klick, Roll-over oder Tippen. Gibt es keine passende Garantie, wird nichts angezeigt.

data-identifier: der Produktcode genau wie auf dem Label: der Modellcode des Herstellers (z. B. WGG244Z0BY) oder der EAN-Barcode.
data-country: ISO-Code (RO, DE, …). Für EU-weite Garantien leer lassen.
data-mode: latest (Standard: neueste verifizierte Version) oder pinned + data-version="3" für eine feste Label-Version.

Direktmodus: Dauer selbst angeben

Wenn Sie keine Datenbankabfrage möchten, übergeben Sie die Dauer direkt mit data-years. Das Nested-Label für diese Dauer wird sofort aus einem statischen SVG angezeigt. data-brand und data-identifier sind erforderlich: Sie werden auf das vollständige Label gedruckt, das sich bei Interaktion öffnet und das Produkt identifizieren muss.

Das Nested-SVG liegt unter einer stabilen URL (/labels/nested-5.svg, /labels/nested-2_5.svg …), wird einmal erzeugt und dann statisch ausgeliefert – perfekt für CDNs.

Live-Demoseite ansehen ↗

4. Abfrage-API

GET https://garan.ro/api/embed/lookup?brand=Bosch&identifier=WGG244Z0BY&identifier_type=model&country=RO Positive Antwort: { "found": true, "status": "source_backed", "duration_years": 5, "version": 1, "nested_svg_url": "https://garan.ro/labels/….svg", "full_svg_url": "https://garan.ro/labels/….svg", "qr_url": "https://europa.eu/youreurope/commercial-guarantee-durability/index.htm", "product_url": "https://…" } Negative Antwort: { "found": false }

Antworten sind cachebar (Cache-Control), und Label-SVGs sind unveränderliche statische Dateien, die ohne PHP ausgeliefert werden – CDN-freundlich.

Grundsätze

✔ Kostenlos, kein Konto nötig für den Hinweis und den Generator
✔ Keine Cookies, keine Werbung, kein aggressives Tracking – nur anonyme, aggregierte Abfragezähler
✔ Labels ausschließlich aus den offiziellen EU-Vorlagen erstellt; nur die zulässigen Felder werden bearbeitet
✔ Das vollständige Label ist vom Nested-Label aus bei der ersten relevanten Interaktion immer erreichbar