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
ParametrOpisPrzykład
sizeRozmiar obrazu w pikselach (100–2048)1024
fgColorKolor pierwszego planu (hex, zakodowany URL)%23009eff
bgColorKolor tła (hex, zakodowany URL)%23ffffff
qrStyleStyl modułusquares, dots lub fluid
eyeStyleStyl wzoru okasquare lub rounded
eyeColorInnerWewnętrzny kolor oka (hex)%23ff0000
eyeColorOuterZewnętrzny kolor oka (hex)%230000ff
logoImageURL obrazu logohttps://example.com/logo.png
logoWidthSzerokość logo w pikselach60
logoHeightWysokość logo w pikselach60
logoPaddingOdstęp wokół logo w pikselach10
logoStyleKształt odstępu logosquare 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:

  1. 1Style domyślne — Czarny pierwszy plan na przezroczystym tle, kwadratowe moduły, 1024px
  2. 2Zapisane style — Wszystkie dostosowania dokonane w edytorze kodów QR lub ustawione przez API Linków są przechowywane z linkiem
  3. 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

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

Karta kredytowa nie jest wymagana