🖥️ API - Promo Widget

Animowane banery reklamowe do osadzania na stronach zewnętrznych, promujące usługi IT znajdzswojczas.pl

Endpointy

GET/promo/mini_blockwidth: 380px▶ Try it

Poziomy baner 380px - pierwsza linia adres + druga linia rabat i kod promocyjny.

Przykład – wersja domyślna

https://znajdzswojczas.pl/promo/mini_block?promo_code=OLKOFF26

Przykład – wersja alternatywna (niebieski gradient, size=2)

https://znajdzswojczas.pl/promo/mini_block?promo_code=OLKOFF26&size=2&alternative_version=1

GET/promo/macro_blockwidth: 320px▶ Try it

Kompaktowy baner 320px - domena na górze, rabat i kod poniżej.

Przykład – wersja domyślna

https://znajdzswojczas.pl/promo/macro_block?promo_code=OLKOFF26

Przykład – wersja alternatywna (niebieski gradient, size=2)

https://znajdzswojczas.pl/promo/macro_block?promo_code=OLKOFF26&size=3&alternative_version=1

Parametry URL

Parametr	Typ	Domyślnie	Opis
promo_codeoptional	string	—	Kod rabatowy odczytywany z bazy danych. Musi być aktywny, nie wygasły i nie wyczerpany.
sizeoptional	number (1–10)	1	Mnożnik rozmiaru. Skala rośnie o połowę kroku (size=2 → 1.5×, size=3 → 2×). Max 10.
alternative_versionoptional	"1"	—	Wersja kolorystyczna. Wartość "1" włącza gradient #2D5AD5 → #1B1F2E zamiast domyślnego czarnego.

Osadzanie (iframe)

Banery są zaprojektowane do osadzania jako <iframe> na stronach zewnętrznych.

Mini Block

<iframe
  src="https://znajdzswojczas.pl/promo/mini_block?promo_code=OLKOFF26"
  width="380" height="48"
  frameborder="0" scrolling="no"
  style="border:none; overflow:hidden;"
></iframe>

Macro Block

<iframe
  src="https://znajdzswojczas.pl/promo/macro_block?promo_code=OLKOFF26"
  width="320" height="48"
  frameborder="0" scrolling="no"
  style="border:none; overflow:hidden;"
></iframe>

Walidacja kodu

Baner automatycznie weryfikuje kod przy każdym żądaniu. Jeśli kod nie przejdzie walidacji, wyświetlany jest placeholder ??% ZNIŻKI / XXXXXXXX.

Warunek	Zachowanie
Kod nieprawidłowy	Placeholder
active = false	Placeholder
expires_at w przeszłości	Placeholder
used_count >= max_uses	Placeholder
Kod prawidłowy	Wyświetla wartość z DB (percent lub fixed)