Generator kodów QR API

Generuj obrazy kodów QR dodając .qr.png do dowolnego krótkiego linku Linkly. Nie wymagana autentykacja ani klucz API.

Obraz jest zwracany jako PNG ze wszystkimi zapisanymi stylami kodów QR, w tym niestandardowymi kolorami, wzorami kropek, stylami oczu i logami.

Podstawowe użycie

Dodaj .qr.png do dowolnego krótkiego linku Linkly:

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

Zwraca to obraz PNG o rozmiarze 1024x1024 kod QR. 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 e-maila, pliku PDF lub dowolnym systemie obsługującym adresy URL obrazów.

Parametry stylów

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

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

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

Wymiary loga są automatycznie skalowane, aby odpowiadały żądanemu rozmiarowi obrazu.

quietZone dodaje odstęp białej przestrzeni wokół całego kodu QR, wypełniony kolorem bgColor. Jest to przydatne podczas drukowania kodów QR na ciemnych tłach — bez niego oczy pozycjonujące znajdują się bezpośrednio przy krawędzi i mogą nie skanować się niezawodnie. Na przykład, quietZone=50&bgColor=%23ffffff dodaje 50-pikselową białą ramkę.

Ustawianie stylów za pośrednictwem interfejsu API linku

Możesz zapisać style kodów QR do linku podczas jego tworzenia lub aktualizacji za pośrednictwem interfejsu API skracania linków. Przekaż obiekt JSON qr_styles z dowolnymi z kluczy stylów wymienionych 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 parametry zapytania.

Jak style są stosowane

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

1. 1
   Style domyślne — Czarny pierwszy plan na przezroczystym tle, moduły kwadratowe, 1024px
2. 2
   Zapisane style — Wszelkie dostosowania, które wykonałeś w edytorze kodów QR lub ustawiłeś za pośrednictwem interfejsu API linku, są przechowywane z linkiem
3. 3
   Zastąpienia parametrów zapytania — Zastąp poszczególne style dla każdego żądania za pośrednictwem parametrów URL

Gdy obecne jest logo, Linkly automatycznie używa korekcji błędów na wysokim poziomie (poziom H), aby zapewnić, że kod QR pozostaje skanowalny.

Limity szybkości

Punkt końcowy ma limit szybkości 5 żądań na sekundę na adres IP. Obrazy są buforowane przez 5 minut, więc powtórzone żądania dla tego samego kodu QR są obsługiwane szybko.

Odpowiedź

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

Błędne odpowiedzi zwracają JSON:

{"error": "Przekroczono limit szybkości"}

Powiązane zasoby

• Twórz kody QR - Jak tworzyć i dostosowywać kody QR w Linkly
• Dodaj logo do kodu QR - Twórz markowe kody QR z logo swojej firmy
• Kody QR SVG - Pobierz kody QR w skalowalnym formacie wektorowym
• Interfejs API skracania linków - Twórz i zarządzaj linkami programowo
• Interfejs API analityki - Eksportuj dane kliknięć i raporty ruchu