Generátor kodów QR API

Generuj obrazy kodów QR, dodając .qr.png do dowolnego krótkiego linku Linkly. Brak wymaganego uwierzytelnienia lub klucza API.

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

Podstawowe użycie

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

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

To zwraca obraz PNG kodu QR o wymiarach 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="QR Code" />

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

Parametry stylu

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ć zakodowane w adresie URL — użyj %23 zamiast # (np. %23ff0000 dla #ff0000).

Wymiary logo są automatycznie skalowane, aby odpowiadać żądanemu rozmiarowi obrazu.

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

Ustawianie stylów za pomocą API linkowania

Możesz zapisać style kodu QR do linku podczas tworzenia lub aktualizowania go za pomocą API skracania linków. 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 parametry zapytania.

Jak są stosowane style

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

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

Gdy obecne jest logo, Linkly automatycznie używa wysokiej korekcji błędów (Level H), aby zapewnić skanowanie kodu QR.

Limity szybkości

Punkt końcowy jest ograniczony do 5 żądań na sekundę na adres IP. Obrazy są buforowane przez 5 minut, więc powtarzające się żądania dla tego samego kodu QR są obsługiwane szybko.

Odpowiedź

Pomyślne żą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"}

Powiązane zasoby

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