Automatizează codurile QR cu Python: bibliotecă sau API REST?

Ce poate o bibliotecă Python

Cine vrea să genereze coduri QR cu Python găsește mai multe biblioteci gratuite. Ele transformă un text într-o imagine, adesea și în SVG, local și fără vreun serviciu. Pentru etichete cu numere de serie, documente interne sau accesul la rețeaua Wi-Fi, e exact ce trebuie.

Unde imaginile statice își găsesc limitele

Un cod QR generat astfel este static, conținutul stă în model. Dacă destinația se schimbă din cauza unei relansări a site-ului, dacă o greșeală de scriere se observă abia după tipărire sau dacă vrei să știi de câte ori este scanat, nu te ajută. Pentru asta există codurile QR dinamice: Same-QR păstrează destinația în spatele unei adrese scurte, care rămâne aceeași, numără scanările și verifică noaptea dacă fiecare destinație este accesibilă.

Coduri QR dinamice prin API REST

API-ul se află la https://sameqr.com/api/v1. În tabloul de bord, la Cont, „Acces pentru CLI, scripturi și agenți”, creează o cheie, „citire + scriere” pentru creare, și setează-o ca variabilă de mediu SAMEQR_API_KEY. Acest exemplu folosește doar biblioteca standard:

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

Dacă API-ul răspunde cu o eroare, urlopen aruncă o excepție. Conținutul include mereu un obiect error cu status, code și message. Verifică-l, în loc să lași scriptul să ruleze mai departe fără să te uiți la rezultat.

Un flux din practică

Un producător tipărește pe fiecare ambalaj un cod QR către instrucțiuni:

• Scriptul citește lista de produse dintr-un fișier CSV.
• Pentru fiecare produs nou creează un cod QR și își notează identificatorul lui lângă numărul articolului.
• Când apare o versiune nouă a instrucțiunilor, schimbă prin PATCH pe /qr/<id> doar destinația. Pentru asta are nevoie de o cheie „complet” și de antetul X-Confirm cu starea citită.
• Un al doilea script, cu cheie de citire, preia o dată pe lună numărul de scanări.

Ține cont de limite: cel mult 10 schimbări de destinație pe oră și 30 pe zi prin API, 120 de cereri pe minut pentru fiecare cheie, pe oră 60 în tariful gratuit, 300 în Start, 1.000 în Pro și 5.000 în Agentur. La 429 aștepți secundele indicate în antetul Retry-After.

Cheia în siguranță în script

• Nu scrie niciodată cheia în fișierul .py, ci citește-o din mediu.
• Pentru scripturile care doar citesc, folosește o cheie „doar citire”.
• Pentru fiecare script, o cheie separată, cu un nume sugestiv și o valabilitate potrivită.

Concluzie: de ce Same-QR

Pentru codurile QR statice ajunge o bibliotecă. De îndată ce se tipărește, Same-QR este baza mai bună: un API REST simplu în orice tarif, erori ușor de înțeles, protecție împotriva suprascrierii în paralel și destinații pe care le poți schimba și după tipărire.

Începe chiar acum: înregistrează-te gratuit pe sameqr.com, 20 de coduri QR dinamice sunt gratuite permanent. API, CLI și server MCP există în orice tarif, iar documentația se află pe sameqr.com/entwickler.

Întrebări frecvente