QR-kódok automatizálása Pythonnal: függvénytár vagy REST API?

Mit tud egy Python-függvénytár

Aki QR-kódokat akar készíteni Pythonnal, több ingyenes függvénytárat talál. Egy szövegből képet csinálnak, gyakran SVG-t is, helyben és szolgáltatás nélkül. Sorozatszámos címkékhez, belső dokumentumokhoz vagy wifi-hozzáférésekhez ez pontosan megfelelő.

Hol érnek határt a statikus képek

Az így készült QR-kód statikus, a tartalom a mintázatban van. Ha egy újraindítás miatt változik a cél, egy elírás csak a nyomtatás után tűnik fel, vagy tudni akarod, hányszor szkennelik, akkor nem segít. Erre valók a dinamikus QR-kódok: a Same-QR a célt egy rövid, változatlan cím mögött tárolja, számolja a szkenneléseket, és éjszaka ellenőrzi, hogy minden cél elérhető-e.

Dinamikus QR-kódok REST API-val

Az API a https://sameqr.com/api/v1 címen érhető el. Hozz létre az irányítópulton a Fiók, „Hozzáférés CLI-hez, szkriptekhez és ügynökökhöz” menüpontban egy kulcsot, létrehozáshoz „olvasás + írás” jogosultsággal, és állítsd be SAMEQR_API_KEY környezeti változóként. Ez a példa csak a szabványos függvénytárat használja:

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

Ha az API hibával válaszol, az urlopen kivételt dob. A tartalom mindig tartalmaz egy error objektumot status, code és message mezővel. Értékeld ki, ahelyett hogy vakon futni hagynád a szkriptet.

Egy gyakorlati folyamat

Egy gyártó minden csomagolásra QR-kódot nyomtat a használati útmutatóhoz:

• A szkript a terméklistát egy CSV-fájlból olvassa.
• Minden új termékhez létrehoz egy QR-kódot, és a cikkszám mellé elmenti az azonosítóját.
• Ha megjelenik az útmutató új változata, PATCH kéréssel a /qr/<id> címen csak a célt módosítja. Ehhez „teljes” kulcs és az X-Confirm fejléc kell az olvasott állapottal.
• Egy második, olvasókulcsos szkript havonta egyszer lekéri a szkennelések számát.

Számolj a korlátokkal: legfeljebb 10 célmódosítás óránként és 30 naponta az API-n keresztül, 120 kérés percenként kulcsonként, óránként 60 az ingyenes csomagban, 300 a Startban, 1.000 a Proban és 5.000 az Agenturban. 429-es válasznál várd ki a Retry-After fejlécben megadott másodperceket.

Kulcs biztonságosan a szkriptben

• A kulcsot soha ne írd bele a .py fájlba, hanem a környezetből olvasd be.
• A csak olvasó szkriptekhez „csak olvasható” kulcsot használj.
• Szkriptenként külön kulcs, beszédes névvel és megfelelő érvényességgel.

Összegzés: miért a Same-QR

Statikus QR-kódokhoz elég egy függvénytár. Amint nyomtatásra kerül a sor, a Same-QR a jobb alap: karcsú REST API minden csomagban, érthető hibák, védelem a párhuzamos felülírás ellen, és olyan célok, amelyeket nyomtatás után is megváltoztathatsz.

Kezdj bele rögtön: regisztrálj ingyen a sameqr.com oldalon, 20 dinamikus QR-kód tartósan ingyenes. Az API, a CLI és az MCP-szerver minden csomagban elérhető, a dokumentáció a sameqr.com/entwickler címen található.

Gyakran ismételt kérdések