Generator kodu QR API

Generuj obrazy kodów QR, dodając .qr.png do dowolnego skróconego łącza Linkly. Brak wymagania uwierzytelnienia lub klucza API.

Obraz jest zwracany jako PNG ze wszystkimi zastosowanymi zapisanymi stylami kodu QR, w tym niestandardowymi kolorami, wzorami kropek, stylami oczu i logo.

Podstawowe użycie

Dodaj .qr.png do dowolnego skróconego łącza Linkly:

https://linkly.link/2W6Z9.qr.png

To zwraca obraz PNG kodu QR o rozmiarze 1024x1024. Jeśli dostosowałeś kolory, styl lub logo kodu QR w Linkly, te style są automatycznie stosowane.

Przykład

Osadź kod QR na stronie HTML:

<img src="https://linkly.link/2W6Z9.qr.png" alt="Kod QR" />

Lub użyj go w szablonie wiadomości e-mail, PDF-ie lub dowolnym systemie obsługującym adresy URL obrazów.

Parametry stylu

Przekaż parametry zapytania, aby zastąpić zapisane style QR łącza lub zmienić rozmiar obrazu:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Uwaga: kolory heksadecymalne muszą być kodowane w URL — użyj %23 zamiast # (np. %23ff0000 zamiast #ff0000).

Wymiary logo są automatycznie skalowane, aby pasować do żądanego rozmiaru obrazu.

quietZone dodaje wypełnienie białego miejsca wokół całego kodu QR, wypełnione kolorem bgColor. Jest to przydatne podczas drukowania kodów QR na ciemnych tłach — bez niego oczy pozycjonujące siedzą przy krawędzi i mogą nie skanować niezawodnie. Na przykład quietZone=50&bgColor=%23ffffff dodaje białą obwódkę o szerokości 50 pikseli.

Ustawianie stylów za pośrednictwem interfejsu API łącza

Możesz zapisać style kodu QR do łącza podczas tworzenia lub aktualizacji za pośrednictwem Link Shortening API. Przekaż obiekt JSON qr_styles z dowolnymi kluczami stylu wymienionymi powyżej:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Po zapisaniu te style są automatycznie stosowane za każdym razem, gdy żądasz obrazu .qr.png — nie są potrzebne żadne parametry zapytania.

Jak style są stosowane

Style kodu QR są rozwiązywane w następującej kolejności:

1. 1
   Style domyślne — Czarny pierwszy plan na przezroczystym tle, kwadratowe moduły, 1024 px
2. 2
   Zapisane style — Wszelkie dostosowania, które dokonałeś w edytorze kodów QR lub ustawiłeś za pośrednictwem interfejsu API łącza, są przechowywane z łączem
3. 3
   Zastępowania parametrów zapytania — Zastąp poszczególne style na żądanie za pośrednictwem parametrów URL

Gdy obecne jest logo, Linkly automatycznie używa wysokiej korekcji błędów (Level H), aby upewnić się, że kod QR pozostaje możliwy do skanowania.

Limity szybkości

Endpoint ma limit 5 żądań na sekundę na adres IP. Obrazy są przechowywane w pamięci podręcznej przez 5 minut, więc powtórzone żądania dla tego samego kodu QR są serwowane szybko.

Odpowiedź

Pomyślne żądanie zwraca status 200 z Content-Type: image/png i danymi obrazu PNG jako treść odpowiedzi.

Odpowiedzi na błędy zwracają JSON:

{"error": "Rate limit exceeded"}

Powiązane zasoby

• Tworzenie kodów QR - Jak tworzyć i dostosowywać kody QR w Linkly
• Dodawanie logo do kodu QR - Twórz markowe kody QR z logo Twojej firmy
• Kody QR SVG - Pobierz kody QR w formacie wektorowym, który można skalować
• Link Shortening API - Programowo twórz i zarządzaj łączami
• Analytics API - Eksportuj dane kliknięć i raporty ruchu