Automatizace QR kódů v Pythonu: knihovna, nebo REST API?

Co zvládne knihovna pro Python

Kdo chce generovat QR kódy v Pythonu, najde několik volných knihoven. Udělají z textu obrázek, často i SVG, lokálně a bez služby. Pro štítky se sériovými čísly, interní dokumenty nebo přístup k Wi-Fi je to přesně ono.

Kde statické obrázky narážejí na meze

Takto vytvořený QR kód je statický, obsah je ukrytý ve vzoru. Když se cíl změní kvůli novému webu, překlep se objeví až po tisku nebo chceš vědět, kolikrát se skenuje, nepomůže ti. Na to existují dynamické QR kódy: Same-QR uloží cíl za krátkou, neměnnou adresu, počítá skeny a v noci kontroluje, zda je každý cíl dostupný.

Dynamické QR kódy přes REST API

API je na https://sameqr.com/api/v1. V dashboardu v části Účet, „Přístup pro CLI, skripty a agenty“, vytvoř klíč, na vytváření „čtení + zápis“, a nastav ho jako proměnnou prostředí SAMEQR_API_KEY. Tento příklad používá jen standardní knihovnu:

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"])

Pokud API odpoví chybou, urlopen vyhodí výjimku. Obsah vždy obsahuje objekt error s položkami status, code a message. Vyhodnoť ho, místo abys nechal skript slepě běžet dál.

Postup z praxe

Výrobce tiskne na každý obal QR kód k návodu:

• Skript načte seznam produktů ze souboru CSV.
• Pro každý nový produkt založí QR kód a jeho identifikátor si poznamená k číslu artiklu.
• Když vyjde nová verze návodu, změní přes PATCH na /qr/<id> jen cíl. K tomu potřebuje klíč „plný“ a hlavičku X-Confirm s přečteným stavem.
• Druhý skript s klíčem pro čtení jednou měsíčně stáhne počty skenů.

Počítej s limity: nejvýše 10 změn cíle za hodinu a 30 za den přes API, 120 požadavků za minutu na jeden klíč, za hodinu 60 v bezplatném tarifu, 300 ve Startu, 1.000 v Pro a 5.000 v Agentuře. Při 429 počkej tolik sekund, kolik je v hlavičce Retry-After.

Bezpečný klíč ve skriptu

• Klíč nikdy nepiš do souboru .py, ale čti ho z prostředí.
• Pro skripty, které jen čtou, použij klíč „jen čtení“.
• Na každý skript vlastní klíč s výstižným názvem a vhodnou platností.

Závěr: proč Same-QR

Pro statické QR kódy stačí knihovna. Jakmile se tiskne, je Same-QR lepším základem: štíhlé REST API v každém tarifu, srozumitelné chyby, ochrana před souběžným přepsáním a cíle, které můžeš po tisku ještě změnit.

Začni hned: zaregistruj se zdarma na sameqr.com, 20 dynamických QR kódů je trvale zdarma. API, CLI a server MCP jsou v každém tarifu, dokumentace je na sameqr.com/entwickler.

Často kladené otázky