Geliştirici Dokümantasyonu & API Kılavuzu SVG & Base64 Standardı

QR Kod Veri Formatları ve Şablon Kılavuzu

Akıllı telefon kameralarının ve optik okuyucuların doğrudan tanıdığı evrensel protokol şablonları (Wi-Fi, vCard 3.0, mailto, tel, SMS, WhatsApp, Geo) ve pratik cURL örnekleri.

Canlı QR Aracı

Dokümantasyon Menüsü

QR Kod Aracına Dön

Hızlı İstek (cURL)

curl -s "https://clskn.net/api/qr?text=https://example.com"

Standart QR Kod Protokolleri

QR kodlar yalnızca standart web bağlantılarını değil; donanım düzeyinde tanınan evrensel URI şemalarını (WIFI, vCard, mailto, tel, smsto, geo vb.) destekler. Bir akıllı telefon kamerası bu şablonlardan birini algıladığında, kullanıcıyı ilgili yerel uygulamaya (Kişiler, Haritalar, Mesajlar, Telefon veya Wi-Fi ayarları) tek dokunuşla aktarır.

URL Encoding İpucu

HTTP GET isteklerinde text parametresine özel karakterler (:, ;, /, ?, &, #, +) gönderirken bu karakterleri mutlaka URL Encode (yüzde kodlaması, örn: : yerine %3A, ; yerine %3B) olarak iletmelisiniz.

URL Protokolü Standart Web

1. Web Sitesi Bağlantısı (URL)

Kullanıcıyı doğrudan bir web sitesine yönlendirmek için tam protokolü (https://) ile birlikte URL tanımlanır.

Format Kalıbı: https://example.com/sayfa?ref=qr

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=https://example.com" -o qr-url.svg

Wi-Fi Protokolü WIFI: URI

2. Wi-Fi Ağına Bağlanma

Mobil cihazların şifre girmeden ağa bağlanmasını sağlayan protokoldür. T (şifreleme: WPA/WEP/nopass), S (SSID), P (parola) ve H (gizli ağ: true/false) alanlarını barındırır.

Format Kalıbı: WIFI:T:WPA;S:Ornek-WiFi;P:ornekSifre123;H:false;;

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=WIFI%3AT%3AWPA%3BS%3AOrnek-WiFi%3BP%3AornekSifre123%3B%3B" -o qr-wifi.svg

Kartvizit Protokolü vCard 3.0

3. Dijital Kartvizit (vCard 3.0)

İsim, unvan, şirket, telefon, e-posta ve web sitesi gibi kurumsal iletişim bilgilerini mobil rehbere tek dokunuşla kaydettiren uluslararası kartvizit standardıdır.

Format Kalıbı:

BEGIN:VCARD
VERSION:3.0
N:Yılmaz;Ahmet;;;
FN:Ahmet Yılmaz
ORG:Örnek Şirket
TITLE:Yazılım Uzmanı
TEL;TYPE=CELL:+905550000000
EMAIL:ahmet.yilmaz@example.com
URL:https://example.com
END:VCARD

cURL İsteği (cURL Data-Urlencode ile):

curl -s "https://clskn.net/api/qr" --data-urlencode "text=BEGIN:VCARD
VERSION:3.0
N:Yılmaz;Ahmet;;;
FN:Ahmet Yılmaz
ORG:Örnek Şirket
TEL;TYPE=CELL:+905550000000
EMAIL:ahmet.yilmaz@example.com
URL:https://example.com
END:VCARD" -G -o qr-vcard.svg

Metin UTF-8 String

4. Düz Metin (Plain Text)

Seri numaraları, ürün barkod notları, kısa duyurular veya kriptografik hash dizgileri için ham metin formatı.

Format Kalıbı: Bu bir ornek urun seri numarasidir: SN-2026-99042

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=Bu+bir+ornek+urun+seri+numarasidir%3A+SN-2026-99042" -o qr-text.svg

E-posta Protokolü mailto: URI

5. E-posta Gönderimi (mailto)

Cihazın yerel e-posta istemcisini (Apple Mail, Gmail, Outlook) alıcı adresi, opsiyonel konu ve mesaj gövdesi ile önceden doldurulmuş olarak açar.

Format Kalıbı: mailto:iletisim@example.com?subject=Destek%20Talebi&body=Merhaba%2C%20bilgi%20almak%20istiyorum.

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=mailto%3Ailetisim%40example.com%3Fsubject%3DDestek%26body%3DMerhaba" -o qr-email.svg

Telefon Protokolü tel: URI

6. Telefon Araması (tel)

Kullanıcının telefon tuş takımını belirtilen numara yazılmış halde açar ve tek tıkla arama yapmasını sağlar.

Format Kalıbı: tel:+905550000000

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=tel%3A%2B905550000000" -o qr-phone.svg

SMS Protokolü SMSTO: URI

7. SMS Gönderimi (smsto)

Varsayılan mesajlaşma uygulamasını hedef telefon numarası ve hazır mesaj metniyle birlikte başlatır.

Format Kalıbı: SMSTO:+905550000000:Merhaba, bu bir ornek SMS mesajidir.

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=SMSTO%3A%2B905550000000%3AMerhaba" -o qr-sms.svg

WhatsApp Protokolü wa.me URI

8. WhatsApp Sohbeti Başlatma

Kullanıcıyı doğrudan WhatsApp uygulamasına yönlendirir. Numara uluslararası formatta (ülke kodu ile birlikte, başında + veya 00 olmadan) yazılmalıdır.

Format Kalıbı: https://wa.me/905550000000?text=Merhaba%2C%20bilgi%20almak%20istiyorum.

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=https%3A%2F%2Fwa.me%2F905550000000%3Ftext%3DMerhaba" -o qr-wa.svg

Konum Protokolü geo: URI

9. Harita & Coğrafi Koordinat (geo)

Enlem (latitude) ve boylam (longitude) değerlerini içeren koordinat şeması. Cihazın varsayılan harita uygulamasında (Google Maps, Apple Maps) bu noktayı iğneler.

Format Kalıbı: geo:41.0082,28.9784?q=41.0082,28.9784(Ornek%20Nokta)

cURL İsteği:

curl -s "https://clskn.net/api/qr?text=geo%3A41.0082%2C28.9784" -o qr-geo.svg