API Dokümantasyonu

QR Kodları

QR Kodları API

Dinamik QR kodlarını programlı olarak oluşturun, güncelleyin ve yönetin. Her QR kodu, renkler, logolar ve izleme yetenekleri ile özelleştirilebilir.

Uç Noktaları

Yöntem	Uç Noktası	Açıklama
POST	/organizations/:orgId/qr-codes	Yeni bir QR kodu oluşturun
GET	/organizations/:orgId/qr-codes	Tüm QR kodlarını listele
GET	/organizations/:orgId/qr-codes/:id	Belirli bir QR kodu alın
PUT	/organizations/:orgId/qr-codes/:id	Bir QR kodunu güncelleyin
DELETE	/organizations/:orgId/qr-codes/:id	Bir QR kodunu silin
GET	/organizations/:orgId/qr-codes/:id/download	QR kodu görüntüsünü indir

QR Kodu Oluştur

Özelleştirilebilir içerik ve stil ile yeni bir dinamik QR kodu oluşturun.

POST

/organizations/:orgId/qr-codes

Talep Gövdesi

Parametre	Yazın	Gerekli	Açıklama
type	string	Gerekli	QR kod türü (URL, VCARD, WIFI, vb.)
name	string	Gerekli	QR kodu için görüntüleme adı
data	object	Gerekli	İçerik verisi (türe göre değişir)
style	object	Opsiyonel	Görsel özelleştirme seçenekleri
folderId	string	Opsiyonel	QR kodunu düzenlemek için klasör
tags	string[]	Opsiyonel	Kategorileme için etiketler

Türüne Göre Örnekler

URL QR Kodu

curl -X POST \
  https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "URL",
    "name": "Company Website",
    "data": {
      "url": "https://example.com"
    },
    "style": {
      "foregroundColor": "#000000",
      "backgroundColor": "#FFFFFF",
      "cornerRadius": 10
    }
  }'

Yanıt

{
  "id": "qr_xyz789",
  "type": "URL",
  "name": "Company Website",
  "shortUrl": "https://ilqr.co/xyz789",
  "shortCode": "xyz789",
  "data": {
    "url": "https://example.com"
  },
  "style": {
    "foregroundColor": "#000000",
    "backgroundColor": "#FFFFFF",
    "cornerRadius": 10
  },
  "status": "ACTIVE",
  "totalScans": 0,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

QR Kodlarını Listele

Filtreleme seçenekleri ile birlikte sayfalı bir QR kodu listesi al.

GET

/organizations/:orgId/qr-codes

Sorgu Parametreleri

Parametre	Yazın	Açıklama
page	number	Sayfa numarası (varsayılan: 1)
limit	number	Sayfa başına öğe (varsayılan: 20, maksimum: 100)
type	string	QR kod türüne göre filtrele
folderId	string	Klasöre göre filtrele
search	string	İsme göre ara
status	string	Duruma göre filtrele (AKTİF, ARŞİVLİ)

QR Kodunu Güncelle

Mevcut bir QR kodunun içeriğini, stilini veya meta verilerini güncelleyin. QR kodu resmi aynı kalırken, hedef değişir.

PUT

/organizations/:orgId/qr-codes/:id

curl -X PUT \
  https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789 \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Website",
    "data": {
      "url": "https://new-url.example.com"
    }
  }'

QR Kodu Sil

Bir QR kodunu kalıcı olarak silin. Bu işlem geri alınamaz. Kısa URL çalışmayı durduracaktır.

DELETE

/organizations/:orgId/qr-codes/:id

curl -X DELETE \
  https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789 \
  -H "X-API-Key: YOUR_API_KEY"

Desteklenen QR Kod Türleri

URL

Herhangi bir web sitesine veya web sayfasına bağlantı

VCARD

İletişim bilgilerini paylaşın

WIFI

WiFi ağlarına bağlanın

PDF

PDF belgelerine bağlantı

EMAIL

Önceden doldurulmuş e-posta taslağı

SMS

Önceden doldurulmuş SMS mesajı

PHONE

Doğrudan telefon görüşmesi

TEXT

Düz metin içeriği

APP

Uygulama mağazası bağlantıları

VIDEO

Video içerik bağlantıları

SOCIAL

Sosyal medya bağlantıları

Sonraki Adımlar

İlgili özellikler hakkında bilgi edinin: