QR Kod Oluşturucu API'si

Herhangi bir Linkly kısa bağlantısına .qr.png ekleyerek QR kod görüntüleri oluşturun. Kimlik doğrulaması veya API anahtarı gerekli değildir.

Görüntü, kaydedilmiş tüm QR kod stilleri uygulanarak PNG olarak döndürülür; özel renkler, nokta desenleri, göz stilleri ve logolar da dahil olmak üzere.

Temel kullanım

Herhangi bir Linkly kısa bağlantısına .qr.png ekleyin:

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

Bu, QR kodun 1024x1024 PNG görüntüsünü döndürür. QR kodun rengini, stilini veya logosunu Linkly'de özelleştirdiyseniz, bu stiller otomatik olarak uygulanır.

Örnek

Bir HTML sayfasına QR kodu yerleştirin:

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

Veya e-posta şablonunda, PDF'de veya görüntü URL'lerini destekleyen herhangi bir sistemde kullanın.

Stil parametreleri

Bağlantının kaydedilmiş QR stillerini geçersiz kılmak veya görüntü boyutunu değiştirmek için sorgu parametreleri geçirin:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Not: onaltılık renkler URL kodlanmalıdır — # yerine %23 kullanın (örneğin #ff0000 için %23ff0000).

Logo boyutları, istenen görüntü boyutuna uyacak şekilde otomatik olarak ölçeklendirilir.

quietZone parametresi, tüm QR kod etrafına bgColor ile doldurulmuş boşluk ekler. Bu, QR kodları koyu arkaplanlar üzerine yazdırırken faydalıdır — olmadan, konumlandırma gözleri kenara doğru yapışır ve güvenilir şekilde taranmayabilir. Örneğin, quietZone=50&bgColor=%23ffffff 50 pikselli beyaz bir kenarlık ekler.

Stilleri Link API'si aracılığıyla ayarlama

Link Kısaltma API'si aracılığıyla bir bağlantı oluştururken veya güncellerken QR kod stillerini kaydedebilirsiniz. Yukarıda listelenen stil anahtarlarından herhangi biriyle bir qr_styles JSON nesnesi geçirin:

{
  "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
  }
}

Kaydedildikten sonra, bu stiller .qr.png görüntüsü istediğinizde otomatik olarak uygulanır — sorgu parametreleri gerekli değildir.

Stiller nasıl uygulanır

QR kod stilleri aşağıdaki sırada çözümlenir:

1. 1
   Varsayılan stiller — Şeffaf arka plan üzerinde siyah ön plan, kare modüller, 1024px
2. 2
   Kaydedilmiş stiller — QR kod düzenleyicisinde yaptığınız veya Link API'si aracılığıyla ayarladığınız özelleştirmeler bağlantı ile saklanır
3. 3
   Sorgu parametresi geçersiz kılmaları — İstek başına URL parametreleri aracılığıyla tek tek stilleri geçersiz kılın

Logo mevcut olduğunda, Linkly otomatik olarak yüksek hata düzeltmesi (Seviye H) kullanarak QR kodun tarabilir kalmasını sağlar.

Hız sınırları

Endpoint, IP adresi başına saniyede 5 istek ile hız sınırlandırılmıştır. Görüntüler 5 dakika süreyle önbelleğe alınır, bu nedenle aynı QR kod için tekrarlanan istekler hızlı şekilde sunulur.

Yanıt

Başarılı bir istek, 200 durumu ile Content-Type: image/png ve PNG görüntü verilerini yanıt gövdesi olarak döndürür.

Hata yanıtları JSON döndürür:

{"error": "Rate limit exceeded"}

İlgili kaynaklar

• QR Kodları Oluşturun - Linkly'de QR kodları oluşturma ve özelleştirme
• QR Koduna Logo Ekleyin - Şirket logonuz ile markalı QR kodları oluşturun
• SVG QR Kodları - QR kodları ölçeklenebilir vektör formatında indirin
• Link Kısaltma API'si - Bağlantıları program aracılığıyla oluşturun ve yönetin
• Analytics API'si - Tıklama verilerini ve trafik raporlarını dışa aktarın