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.

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
| Parametr | Opis | Przykład |
|---|---|---|
| size | Rozmiar obrazu w pikselach (100–2048) | 1024 |
| fgColor | Kolor pierwszoplanowy (hex, kodowany URL) | %23009eff |
| bgColor | Kolor tła (hex, kodowany URL) | %23ffffff |
| qrStyle | Styl modułu | squares, dots lub fluid |
| eyeStyle | Styl wzoru oka | square lub rounded |
| eyeColorInner | Kolor wewnętrznego oka (hex) | %23ff0000 |
| eyeColorOuter | Kolor zewnętrznego oka (hex) | %230000ff |
| logoImage | Adres URL obrazu logotypu | https://example.com/logo.png |
| logoWidth | Szerokość logotypu w pikselach | 60 |
| logoHeight | Wysokość logotypu w pikselach | 60 |
| logoPadding | Odstęp wokół logotypu w pikselach | 10 |
| logoStyle | Kształt wypełnienia logotypu | square lub circle |
| quietZone | Wypeł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:
- 1Style domyślne — Czarny pierwszy plan na przezroczystym tle, moduły kwadratowe, 1024px
- 2Zapisane style — Wszelkie dostosowania dokonane w edytorze kodów QR lub ustawione za pośrednictwem API linków są przechowywane z linkiem
- 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
- Utwórz kody QR - Jak tworzyć i dostosowywać kody QR w Linkly
- Dodaj logotyp do kodu QR - Utwórz kody QR marki z logotypem Twojej firmy
- Kody QR w formacie SVG - Pobierz kody QR w skalowalnym formacie wektorowym
- API skracania linków - Twórz linki i zarządzaj nimi programistycznie
- API analityki - Eksportuj dane kliknięć i raporty ruchu
Śledź 500 kliknięć miesięcznie ze wszystkimi funkcjami włączonymi.
Karta kredytowa nie wymagana