Geliştirici QR Kod API Rehberi

API Anahtarı

Hesabınız için API anahtarını hesap sayfasından oluşturabilirsiniz. API anahtarı, isteklere ya bir URL parametresi olarak, örneğin: https://genqrcode.com/api/public/generate?apikey=SIZIN_API_ANAHTARINIZ, ya da `GenQRCode-apikey` başlığı içinde dahil edilebilir. Bu rehberin geri kalanında, daha güvenli bir seçenek olduğu için başlık kullanımını varsayacağız, ancak her iki yöntem de karşılıklı olarak kullanılabilir. API anahtarını gizli tutmanız ve başkalarıyla paylaşmamanız önemlidir.

Hız Sınırlandırması

Hız sınırlandırması, API'nin adil kullanımını sağlamak için uygulanır. Ücretsiz katman saatte 180 token içerir. Normal QR kodları her biri 1 token alır, bu da saatte maksimum 180 token'a denk gelir ve her 20 saniyede bir QR Kod anlamına gelir. Ayrıca, hızlı çağrı uç noktaları 1/50 token alır, bu da saniyede 2,5 QR Kod'a denk gelir. Bu hızlı uç noktalar, QR Kodunun özelleştirilmesine ihtiyaç duyulmadığında önerilir. Token limiti aşılırsa, isteğin hız sınırlamasına tabi olduğunu belirten 429 durum kodu döndürülür.

Bu limitleri aşmak için birden fazla hesap kullanımı yasaktır. Daha yüksek limitler gerekiyorsa, lütfen fiyatlandırma için bizimle iletişime geçin.

Kütüphaneler

Java Library

Statik QR Kod API'si

Örnek metin QR Kodu

URL	https://api.genqrcode.com/public/generate
İstek yöntemi	POST
Başlıklar	GenQRCode-apikey: API_KEY
Gövde	{ "type": 0, "text": "https://genqrcode.com" }
Yanıt

Örnek Wi-Fi QR Kodu

URL	https://api.genqrcode.com/public/generate
İstek yöntemi	POST
Başlıklar	GenQRCode-apikey: API_KEY
Gövde	{ "type": 1, "network": "GenQRCode", "password": false, "hidden": false, "encryption": "wpa" }
Yanıt

Örnek renkli QR Kodu

URL	https://api.genqrcode.com/public/generate
İstek yöntemi	POST
Başlıklar	GenQRCode-apikey: API_KEY
Gövde	{ "type": 0, "text": "https://genqrcode.com", "color": "#ff0000", "background_color": "#aaffaa", "inner_eye_color": "#ffaaaa", "outer_eye_color": "#ffaaff" }
Yanıt

Örnek renkli desen QR Kodu

URL	https://api.genqrcode.com/public/generate
İstek yöntemi	POST
Başlıklar	GenQRCode-apikey: API_KEY
Gövde	{ "type": 0, "text": "https://genqrcode.com", "color": "#e81416,#faeb36,#79c314,#487de7,#4b369d,#70369d", "custom_color_pattern": "1,1,2,2,3,3,4,4,5,5,6,6" }
Yanıt

Çerçeve, Şekil ve Logo parametreleri

İşte tüm özelleştirilebilir çerçeve, şekil ve logo parametreleri ve nasıl kullanılacakları açıklamaları.

Parametre	Tür	Varsayılan değer	Açıklama
style	Int	0	QR Kodunun karelerinin stili. 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
inner_eye_style	Int	0	QR Kodunun iç gözlerinin stili. 0 1 2 3 4 5 6 7
outer_eye_style	Int	0	QR Kodunun dış gözlerinin stili. 0 1 2 3 4 5 6
frame_style	Int	0	QR Kodunun etrafındaki çerçevenin stili. 0 1 2 3 4 5 6 7 8 9 10 11 12 13
frame_text	String	SCAN ME	Çerçeve içindeki metin. Bu görünür olabilmesi için çerçevenin metinle yapılandırılmış olması gerekir.
logo	String		QR Kodunda kullanılacak logo. youtube wifi google-maps facebook spotify threads zoom instagram linkedin genqrcode google-drive airbnb skype snapchat twitter x-twitter reddit
logo_remove_background	Boolean	false	Logonun arkasındaki arka planın kaldırılıp kaldırılmayacağı.

Örnek logo ve şekil QR Kodu

URL	https://api.genqrcode.com/public/generate
İstek yöntemi	POST
Başlıklar	GenQRCode-apikey: API_KEY
Gövde	{ "type": 0, "text": "https://x.com/genqrcode", "style": 22, "inner_eye_style": 1, "outer_eye_style": 4, "frame": 10, "frame_text": "My X Page", "logo": "x-twitter", "logo_remove_background":true }
Yanıt

Hızlı QR Kod API'si

Hızlı QR Kod API'si, normal API'nin sadece 1/50 token'ını alır. QR Kodları hız ve indirme boyutu için optimize edilmiştir. Tüm QR Kod Türlerini destekler, ancak yalnızca birkaç özelleştirme parametresini destekler.

Örnek hızlı metin QR Kodu

URL	https://api.genqrcode.com/public/fastgenerate
İstek yöntemi	POST
Başlıklar	GenQRCode-apikey: API_KEY
Gövde	{ "imageformat": "png", "type": 0, "text": "https://genqrcode.com" }
Yanıt

Hızlı Toplu QR Kod API'si

{
  "QR Code 1": {
    "text": "https://genqrcode.com",
    "type": 0,
    "width": 500,
    "bordersize": 4,
    "imageformat": "png",
    "height": 500
  },
  "QR Code 2": {
    "text": "https://genqrcode.com/dynamicview",
    "type": 0,
    "width": 500,
    "bordersize": 4,
    "imageformat": "png",
    "height": 500
  },
  "QR Code 3": {
    "text": "https://genqrcode.com/pricing",
    "type": 0,
    "width": 500,
    "bordersize": 4,
    "imageformat": "png",
    "height": 500
  }
}