API Dokümantasyonu

Toplu İşlemler

Toplu QR Kodları Oluştur

QR kodlarınızı API'mizle otomatikleştirin. Büyük kampanyalar, ürün etiketleme veya varlık takibi için mükemmel olan yüzlerce veya binlerce QR kodunu aynı anda oluşturun.

CSV İçe Aktarma

QR kod verilerinizi içeren bir CSV dosyası yükleyin ve hepsini bir kerede oluşturacağız.

API Toplu

JSON yükü ile tek bir API çağrısında birden fazla QR kodu oluşturun.

Asenkron İşleme

Büyük ithalatlar arka planda durum takibi ile çalışır.

Uç Noktaları

Yöntem	Uç Noktası	Açıklama
POST	/organizations/:orgId/qr-codes/bulk-import	CSV'den toplu içe aktarma başlatın
GET	/organizations/:orgId/qr-codes/bulk-import	Tüm ithalat işlerini listele
GET	/organizations/:orgId/qr-codes/bulk-import/:id	İthalat iş durumunu al
GET	/organizations/:orgId/qr-codes/bulk-import/sample	CSV şablonunu indir
POST	/organizations/:orgId/qr-codes/batch/update	Birden fazla QR kodunu toplu güncelleme
POST	/organizations/:orgId/qr-codes/batch/clone	Birden fazla QR kodunu klonla
DELETE	/organizations/:orgId/qr-codes/batch	Birden fazla QR kodunu silin

CSV Toplu İçe Aktarma

Birden fazla QR kodu oluşturmanın en kolay yolu CSV içe aktarmasıdır. Bu adımları izleyin:

CSV şablonunu indirin

QR kod türünüz için doğru biçimlendirmeyi sağlamak üzere şablonu alın.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv

Verilerinizi doldurun

QR kod verilerinizi CSV dosyasına ekleyin. İşte URL QR kodları için bir örnek:

url_qr_codes.csv

name,url,folder,tags
Homepage QR,https://example.com,Marketing,homepage;main
Product Page,https://example.com/product,Products,product;featured
Contact Us,https://example.com/contact,Marketing,contact;support
Promo Landing,https://example.com/promo,Campaigns,promo;summer2024

CSV dosyasını yükleyin

İçe aktarma işini başlatmak için dosyayı gönderin.

İçe Aktarmaya Başla

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@url_qr_codes.csv" \
  -F "type=URL"

İthalat ilerlemesini izle

İthalat işinizin durumunu kontrol edin.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/import_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

Yanıt

{
  "id": "import_abc123",
  "status": "COMPLETED",
  "type": "URL",
  "totalRows": 100,
  "processedRows": 100,
  "successCount": 98,
  "errorCount": 2,
  "errors": [
    { "row": 45, "error": "Invalid URL format" },
    { "row": 72, "error": "Name is required" }
  ],
  "createdAt": "2024-01-15T10:00:00Z",
  "completedAt": "2024-01-15T10:02:30Z"
}

CSV Sütun Referansı

Her QR kodu türü farklı sütunlar gerektirir. İşte en yaygın olanları:

URL QR Kodları

Sütun	Gerekli	Açıklama
name	Gerekli	QR kodu için görüntüleme adı
url	Gerekli	Hedef URL (http:// veya https:// ile başlamalıdır)
folder	Opsiyonel	QR kodunu düzenlemek için klasör adı
tags	Opsiyonel	Noktalı virgülle ayrılmış etiketler

vCard QR Kodları

Sütun	Gerekli	Açıklama
name	Gerekli	QR kodu için görüntüleme adı
firstName	Gerekli	İletişim kişinin adı
lastName	Gerekli	İletişim kişinin soyadı
email	Opsiyonel	E-posta adresi
phone	Opsiyonel	Telefon numarası
company	Opsiyonel	Şirket adı
title	Opsiyonel	İş unvanı

Toplu Güncelleme

Tek bir API çağrısıyla birden fazla QR kodunu güncelleyin.

POST

/organizations/:orgId/qr-codes/batch/update

Toplu Güncelleme Talebi

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/batch/update" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["qr_abc123", "qr_def456", "qr_ghi789"],
    "updates": {
      "folderId": "folder_xyz",
      "style": {
        "foregroundColor": "#1D59F9"
      }
    }
  }'

İthalat Sınırları

Maksimum Satırlar

10,000

CSV dosyası başına QR kodları

Dosya Boyutu Sınırı

10 MB

Maksimum CSV dosya boyutu

İpucu: Çok büyük içe aktarımlar (10.000+ QR kodu) için, CSV'nizi birden fazla dosyaya ayırmayı ve bunları sırasıyla içe aktarmayı düşünün.

Kullanım Senaryoları

Ürün Etiketleme

Envanterinizdeki her ürün için benzersiz QR kodları oluşturun.

Pazarlama Kampanyaları

Her alıcı için kişiselleştirilmiş QR kodları oluşturun.

Varlık Takibi

Ekipmanları, belgeleri veya fiziksel varlıkları etiketleyin

Etkinlik Yönetimi

Benzersiz QR kodları ile biletler veya rozetler oluşturun

Sonraki Adımlar

İlgili özellikler hakkında bilgi edinin: