API Generatora Kodów QR
Generuj obrazy kodów QR, dodając .qr.png do dowolnego krótkiego linku Linkly. Nie wymaga uwierzytelniania ani klucza API.
Obraz jest zwracany jako PNG ze wszystkimi zapisanymi stylami kodu QR, w tym niestandardowymi kolorami, wzorami kropek, stylami oczu i logo.
Podstawowe Użycie
Dodaj .qr.png do dowolnego krótkiego linku Linkly:
https://your-domain.com/ABC123.qr.png
To zwraca obraz PNG 1024x1024 kodu 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://your-domain.com/ABC123.qr.png" alt="Kod QR" />
Lub użyj go w szablonie e-mail, PDF lub dowolnym systemie obsługującym adresy URL obrazów.
Parametry Stylu
Przekaż parametry zapytania, aby nadpisać zapisane style QR linku lub zmienić rozmiar obrazu:
https://your-domain.com/ABC123.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048
| Parametr | Opis | Przykład |
|---|---|---|
| size | Rozmiar obrazu w pikselach (100–2048) | 1024 |
| fgColor | Kolor pierwszego planu (hex, zakodowany URL) | %23009eff |
| bgColor | Kolor tła (hex, zakodowany URL) | %23ffffff |
| qrStyle | Styl modułu | squares, dots lub fluid |
| eyeStyle | Styl wzoru oka | square lub rounded |
| eyeColorInner | Wewnętrzny kolor oka (hex) | %23ff0000 |
| eyeColorOuter | Zewnętrzny kolor oka (hex) | %230000ff |
| logoImage | URL obrazu logo | https://example.com/logo.png |
| logoWidth | Szerokość logo w pikselach | 60 |
| logoHeight | Wysokość logo w pikselach | 60 |
| logoPadding | Odstęp wokół logo w pikselach | 10 |
| logoStyle | Kształt odstępu logo | square lub circle |
Uwaga: kolory hex muszą być zakodowane w URL — użyj %23 zamiast # (np. %23ff0000 dla #ff0000).
Wymiary logo są automatycznie skalowane, aby pasowały do żądanego rozmiaru obrazu.
Ustawianie Stylów przez API Linków
Możesz zapisać style kodu QR w linku podczas tworzenia lub aktualizacji przez 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"
}
}
Po zapisaniu te style są automatycznie stosowane za każdym razem, gdy żądasz obrazu .qr.png — nie są potrzebne parametry zapytania.
Jak Stosowane są Style
Style kodu QR są rozwiązywane w następującej kolejności:
- 1Style domyślne — Czarny pierwszy plan na przezroczystym tle, kwadratowe moduły, 1024px
- 2Zapisane style — Wszystkie dostosowania dokonane w edytorze kodów QR lub ustawione przez API Linków są przechowywane z linkiem
- 3Nadpisania parametrów zapytania — Nadpisz poszczególne style na żądanie za pomocą parametrów URL
Gdy obecne jest logo, Linkly automatycznie używa wysokiej korekcji błędów (Poziom H), aby zapewnić, że kod QR pozostaje skanowalny.
Limity Częstotliwości
Endpoint jest ograniczony do 5 żądań na sekundę na adres IP. Obrazy są przechowywane w pamięci podręcznej przez 5 minut, więc powtarzające się żądania 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 błędów 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 URL swojego krótkiego linku. Jest publiczny i nie wymaga uwierzytelniania.
Czy mogę osadzić obraz kodu QR w e-mailach lub stronach internetowych?
Tak. URL .qr.png jest zaprojektowany do osadzania. Użyj go jako źródła <img> w e-mailach HTML, stronach internetowych, PDF-ach lub dowolnym systemie obsługującym adresy URL obrazów.
Czy niestandardowe kolory i logo są uwzględnione?
Tak. Kody QR są renderowane ze wszystkimi zapisanymi stylami, w tym niestandardowymi kolorami, wzorami kropek/płynów, stylami oczu i logo. Możesz również nadpisać dowolny styl parametrami zapytania.
Jaki jest rozmiar generowanych obrazów?
Domyślny rozmiar to 1024x1024 pikseli. 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 częstotliwości?
Tak. Endpoint jest ograniczony do 5 żądań na sekundę na adres IP. Jeśli przekroczysz ten limit, otrzymasz kod statusu 429.
Czy mogę ustawić style kodu QR przez API?
Tak. Przekaż obiekt qr_styles podczas tworzenia lub aktualizacji linku przez API Skracania Linków. Zapisane style są automatycznie stosowane, gdy żądasz obrazu .qr.png. Zobacz 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. Wsparcie SVG może zostać dodane w przyszłoś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 - Pobieraj kody QR w skalowalnym formacie wektorowym
- API Skracania Linków - Twórz i zarządzaj linkami programistycznie
- API Analityki - Eksportuj dane o kliknięciach i raporty o ruchu
Śledź 500 kliknięć miesięcznie ze wszystkimi włączonymi funkcjami.
Karta kredytowa nie jest wymagana