Python ile QR kodları otomatikleştirme: Kütüphane mi, REST API mi?

Bir Python kütüphanesi ne sağlar

Python ile QR kod üretmek isteyen, birkaç ücretsiz kütüphane bulur. Bir metinden bir görsel, çoğu zaman bir SVG üretirler, yerel olarak ve hizmet olmadan. Seri numaralı etiketler, şirket içi belgeler veya Wi-Fi erişimleri için tam uygundur.

Statik görsellerin sınırlarına dayandığı yer

Bu şekilde üretilen bir QR kod statiktir, içerik desenin içindedir. Hedef bir yeniden yayına başlama yüzünden değişirse, bir yazım hatası ancak baskıdan sonra fark edilirse veya kaç kez tarandığını bilmek istersen, işe yaramaz. Bunun için dinamik QR kodlar var: Same-QR hedefi kısa, sabit kalan bir adresin ardında saklar, taramaları sayar ve geceleri her hedefe ulaşılıp ulaşılamadığını kontrol eder.

REST API ile dinamik QR kodlar

API https://sameqr.com/api/v1 adresinde bulunur. Panelde Hesap altındaki „CLI, komut dosyaları ve ajanlar için erişim“ bölümünde bir anahtar oluştur, oluşturmak için „okuma + yazma“, ve onu SAMEQR_API_KEY ortam değişkeni olarak ayarla. Bu örnek yalnızca standart kütüphaneyi kullanır:

import json, os, urllib.request

API = "https://sameqr.com/api/v1"
KEY = os.environ["SAMEQR_API_KEY"]

def rufe(methode, weg, daten=None):
    req = urllib.request.Request(
        API + weg, method=methode,
        data=json.dumps(daten).encode() if daten else None,
        headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
    with urllib.request.urlopen(req) as r:
        return json.load(r)

code = rufe("POST", "/qr", {"name": "Anleitung Modell A", "targetUrl": "https://example.com/anleitung-a"})
print(code["id"])

API bir hatayla yanıt verirse urlopen bir istisna fırlatır. İçerikte her zaman status, code ve message içeren bir error nesnesi bulunur. Komut dosyasını körü körüne çalıştırmak yerine onu değerlendir.

Uygulamadan bir akış

Bir üretici her ambalaja kılavuza giden bir QR kod basıyor:

• Komut dosyası ürün listesini bir CSV dosyasından okur.
• Her yeni ürün için bir QR kod oluşturur ve kimliğini ürün numarasının yanına kaydeder.
• Kılavuzun yeni bir sürümü çıkarsa, /qr/<id> üzerinde PATCH ile yalnızca hedefi değiştirir. Bunun için „tam“ yetkili bir anahtara ve okunan durumlu X-Confirm başlığına ihtiyaç var.
• Okuma anahtarlı ikinci bir komut dosyası ayda bir tarama sayılarını çeker.

Sınırları hesaba kat: API üzerinden saatte en fazla 10 ve günde 30 hedef değişikliği, anahtar başına dakikada 120 istek, saatte ücretsiz tarifede 60, Start'ta 300, Pro'da 1.000 ve Agentur'da 5.000. 429 durumunda Retry-After başlığında yazan saniye kadar beklersin.

Komut dosyasında anahtarı güvenle kullan

• Anahtarı asla .py dosyasına yazma, ortamdan oku.
• Yalnızca okuyan komut dosyaları için „salt okunur“ bir anahtar kullan.
• Her komut dosyası için anlamlı adı ve uygun süresi olan ayrı bir anahtar.

Sonuç: Neden Same-QR

Statik QR kodlar için bir kütüphane yeter. Basılır basılmaz Same-QR daha iyi bir temeldir: her tarifede sade bir REST API, anlaşılır hatalar, eşzamanlı üzerine yazmaya karşı koruma ve baskıdan sonra bile değiştirebileceğin hedefler.

Hemen başla: sameqr.com'da ücretsiz kaydol, 20 dinamik QR kod kalıcı olarak ücretsiz. API, CLI ve MCP sunucusu her tarifede var, dokümantasyon sameqr.com/entwickler adresinde.

Sık sorulan sorular