API Generatora Kodów QR

Generuj obrazy kodów QR, dodając .qr.png do dowolnego skróconego linku Linkly. Nie wymaga uwierzytelniania ani klucza API.

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

Dodaj .qr.png do dowolnego linku Linkly, aby uzyskać kod QR serwowany jako PNG
Dodaj .qr.png do dowolnego linku Linkly, aby uzyskać kod QR serwowany jako PNG

Podstawowe użycie

Dodaj .qr.png do dowolnego skróconego linku Linkly:

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

Zwraca obraz PNG kodów QR o wymiarach 1024x1024. Jeśli dostosowałeś kolory, styl lub logotyp 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, 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
ParametrOpisPrzykład
sizeRozmiar obrazu w pikselach (100–2048)1024
fgColorKolor pierwszoplanowy (hex, kodowany URL)%23009eff
bgColorKolor tła (hex, kodowany URL)%23ffffff
qrStyleStyl modułusquares, dots lub fluid
eyeStyleStyl wzoru okasquare lub rounded
eyeColorInnerKolor wewnętrznego oka (hex)%23ff0000
eyeColorOuterKolor zewnętrznego oka (hex)%230000ff
logoImageAdres URL obrazu logotypuhttps://example.com/logo.png
logoWidthSzerokość logotypu w pikselach60
logoHeightWysokość logotypu w pikselach60
logoPaddingOdstęp wokół logotypu w pikselach10
logoStyleKształt wypełnienia logotypusquare lub circle
quietZoneWypełnienie wokół kodu QR w pikselach (0–200)50

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

Wymiary logotypu są automatycznie skalowane do żądanego rozmiaru obrazu.

quietZone dodaje wypełnienie białej przestrzeni wokół całego kodu QR, wypełnione bgColor. Jest to przydatne podczas drukowania kodów QR na ciemnych tłach — bez tego pozycjonujące oczy przylegają do krawędzi i mogą nie skanować się niezawodnie. Na przykład, quietZone=50&bgColor=%23ffffff dodaje obramowanie białe 50 pikseli.

Ustawianie stylów przez API linków

Możesz zapisać style kodów QR do linku podczas jego tworzenia lub aktualizacji za pośrednictwem API skracania linków. Przekaż obiekt JSON qr_styles z dowolnymi kluczami stylów 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 kodów QR są rozwiązywane w następującej kolejności:

  1. 1Style domyślne — Czarny pierwszy plan na przezroczystym tle, moduły kwadratowe, 1024px
  2. 2Zapisane style — Wszelkie dostosowania dokonane w edytorze kodów QR lub ustawione za pośrednictwem API linków są przechowywane z linkiem
  3. 3Zastępowania parametrów zapytania — Zastąp poszczególne style na żądanie za pomocą parametrów URL

Gdy obecny jest logotyp, Linkly automatycznie używa korekcji błędu na wysokim poziomie (poziom H), aby zapewnić, że kod QR pozostaje możliwy do skanowania.

Limity szybkości

Punkt końcowy jest ograniczony do 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.

Odpowiedzi o błędach zwracają JSON:

{"error": "Rate limit exceeded"}

FAQ API Generatora Kodów QR

Czy potrzebuję klucza API, aby uzyskać obraz kodu QR?

Nie. Po prostu dodaj .qr.png do adresu URL skróconego linku. To jest publiczne i nie wymaga uwierzytelniania.

Czy mogę osadzić obraz kodu QR w wiadomościach e-mail lub na stronach internetowych?

Tak. Adres URL .qr.png jest przeznaczony do osadzania. Użyj go jako źródła <img> w wiadomościach e-mail HTML, stronach internetowych, plikach PDF lub dowolnym systemie obsługującym adresy URL obrazów.

Czy niestandardowe kolory i logotypy są uwzględnione?

Tak. Kody QR są renderowane ze wszystkimi zapisanymi stylami, w tym niestandardowymi kolorami, wzorami punktów/płynnych, stylami oczu i logotypami. Możesz również zastąpić dowolny styl parametrami zapytania.

Jaki rozmiar mają generowane obrazy?

Rozmiar domyślny to 1024x1024 piksele. Możesz określić niestandardowy rozmiar od 100 do 2048 pikseli za pomocą parametru zapytania size, np. ABC123.qr.png?size=2048.

Czy istnieje limit szybkości?

Tak. Punkt końcowy jest ograniczony do 5 żądań na sekundę na adres IP. Jeśli przekroczysz ten limit, otrzymasz kod stanu 429.

Czy mogę ustawić style kodów QR za pośrednictwem API?

Tak. Przekaż obiekt qr_styles podczas tworzenia lub aktualizacji linku za pośrednictwem API skracania linków. Zapisane style są automatycznie stosowane, gdy żądasz obrazu .qr.png. Zapoznaj się z sekcją Ustawianie stylów przez API linków powyżej.

Czy mogę generować kody QR w formacie SVG?

Jeszcze nie. API obecnie obsługuje tylko format PNG. Obsługa SVG może być dodana w przyszłości.

Powiązane zasoby

Śledź 500 kliknięć miesięcznie ze wszystkimi funkcjami włączonymi.

Karta kredytowa nie wymagana