Osadzanie i API

Jeden globalny skrypt obsługuje zarówno zharmonizowane powiadomienie o gwarancji prawnej, jak i automatyczne odznaki GARAN. Bezpłatny, bez cookies, bez śledzenia, bez zewnętrznych zależności i bezpieczny: jeśli nasze API jest niedostępne, Twój sklep nigdy na tym nie ucierpi.

1. Zainstaluj skrypt (raz, dla całej witryny)

2. Link do powiadomienia o gwarancji prawnej

Dodaj link w dowolnym miejscu (nagłówek, stopka, strona produktu, kasa). Po kliknięciu oficjalne zharmonizowane powiadomienie otwiera się w dostępnym oknie modalnym, w języku strony (<html lang>) lub atrybutu data-lang.

<a href="#garantieEu">Twoje prawa z gwarancji prawnej</a>  <a href="#garantieEu" data-lang="ro">Drepturile tale privind garanția legală</a>

Obsługiwane jest też class="garan-notice-link" na dowolnym elemencie oraz automatyczne wstawianie w selektory CSS skonfigurowane na darmowym koncie (kolory, czcionka, tło, obramowanie i ikona są konfigurowalne dla każdej witryny).

3. Odznaka GARAN na stronach produktów

Automatyczne wyszukiwanie: faza testów. Automatyczne wykrywanie jest wciąż testowane. Odznaka pojawia się tylko wtedy, gdy gwarancja dla dokładnie tego produktu jest zarejestrowana i zweryfikowana w bazie GARAN (Twoje gwarancje lub etykiety publiczne); w przeciwnym razie nic się nie wyświetla. Sprawdź ją na jednej ze stron produktów, zanim użyjesz jej wszędzie, i pomóż, publikując swoje etykiety w publicznym katalogu. Aby uzyskać dziś przewidywalny wynik, użyj poniższego trybu bezpośredniego (data-years).

Umieść pusty element z danymi produktu. Jeśli w bazie GARAN istnieje zweryfikowana handlowa gwarancja trwałości, wyświetlana jest etykieta zagnieżdżona; pełna etykieta otwiera się po pierwszym kliknięciu, najechaniu lub dotknięciu. Jeśli nie ma kwalifikującej się gwarancji, nic się nie wyświetla.

data-identifier: kod produktu dokładnie jak na etykiecie: kod modelu producenta (np. WGG244Z0BY) lub kod kreskowy EAN.
data-country: Kod ISO (RO, DE, …). Pozostaw puste dla gwarancji obowiązujących w całej UE.
data-mode: latest (domyślnie: najnowsza zweryfikowana wersja) lub pinned + data-version="3" dla stałej wersji etykiety.

Tryb bezpośredni: podaj okres samodzielnie

Jeśli nie chcesz wyszukiwania w bazie, podaj okres bezpośrednio w data-years. Etykieta zagnieżdżona dla tego okresu jest wyświetlana od razu ze statycznego SVG. data-brand i data-identifier są wymagane: są drukowane na pełnej etykiecie otwieranej przy interakcji, która musi identyfikować produkt.

Zagnieżdżone SVG ma stały adres URL (/labels/nested-5.svg, /labels/nested-2_5.svg …), jest generowane raz, a następnie serwowane statycznie — idealne dla CDN.

Zobacz stronę demo na żywo ↗

4. API wyszukiwania

GET https://garan.ro/api/embed/lookup?brand=Bosch&identifier=WGG244Z0BY&identifier_type=model&country=RO Odpowiedź pozytywna: { "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://…" } Odpowiedź negatywna: { "found": false }

Odpowiedzi można buforować (Cache-Control), a pliki SVG etykiet to niezmienne pliki statyczne serwowane bez udziału PHP — przyjazne dla CDN.

Zasady

✔ Bezpłatnie, bez konta dla powiadomienia i generatora
✔ Bez cookies, bez reklam, bez agresywnego śledzenia — tylko anonimowe, zbiorcze liczniki wyszukiwań
✔ Etykiety generowane wyłącznie z oficjalnych szablonów UE; edytowane są tylko dozwolone pola
✔ Pełna etykieta jest zawsze dostępna z etykiety zagnieżdżonej przy pierwszej istotnej interakcji