Automatizo kodet QR me Python: bibliotekë apo REST-API?

Çfarë bën një bibliotekë Python

Kush dëshiron të krijojë kode QR me Python, gjen disa biblioteka të lira. Ato e kthejnë një tekst në imazh, shpesh edhe në SVG, lokalisht dhe pa shërbim. Për etiketa me numra serialë, dokumente të brendshme ose qasje në WLAN kjo është pikërisht e duhura.

Ku kufizohen imazhet statike

Një kod QR i krijuar kështu është statik, përmbajtja gjendet në model. Nëse destinacioni ndryshon për shkak të një ristrukturimi, një gabim shtypi vihet re vetëm pas printimit ose dëshiron të dish sa herë skanohet, ai nuk të ndihmon. Për këtë ka kode QR dinamikë: Same-QR e ruan destinacionin pas një adrese të shkurtër e të pandryshueshme, numëron skanimet dhe natën kontrollon nëse çdo destinacion është i arritshëm.

Kode QR dinamikë me REST-API

API-ja gjendet te https://sameqr.com/api/v1. Krijo te paneli, te Llogaria, „Qasje për CLI, skripte dhe agjentë“, një çelës, „leximi + shkrimi“ për krijimin, dhe vëre si ndryshore mjedisi SAMEQR_API_KEY. Ky shembull përdor vetëm bibliotekën standarde:

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

Nëse API-ja përgjigjet me gabim, urlopen hedh një përjashtim. Përmbajtja ka gjithmonë një objekt error me status, code dhe message. Lexoje, në vend që ta lësh skriptin të vazhdojë verbërisht.

Një proces nga praktika

Një prodhues printon në çdo paketim një kod QR për udhëzimet:

• Skripti lexon listën e produkteve nga një skedar CSV.
• Për çdo produkt të ri krijon një kod QR dhe e mban mend identifikuesin e tij pranë numrit të artikullit.
• Kur del një version i ri i udhëzimeve, ai ndryshon me PATCH te /qr/<id> vetëm destinacionin. Për këtë i duhet një çelës „i plotë“ dhe header-i X-Confirm me gjendjen e lexuar.
• Një skript i dytë me çelës leximi merr një herë në muaj numrat e skanimeve.

Llogaritji kufijtë: më së shumti 10 ndryshime destinacioni në orë dhe 30 në ditë përmes API-së, 120 kërkesa në minutë për çelës, në orë 60 në tarifën falas, 300 në Start, 1.000 në Pro dhe 5.000 në Agentur. Te 429 pret sekondat që shkruhen në header-in Retry-After.

Çelësi në skript, në mënyrë të sigurt

• Mos e shkruaj kurrë çelësin në skedarin .py, por lexoje nga mjedisi.
• Për skriptet që vetëm lexojnë, përdor një çelës „vetëm leximi“.
• Për çdo skript një çelës i vet me emër që thotë diçka dhe afat të përshtatshëm.

Përfundim: Pse Same-QR

Për kode QR statikë mjafton një bibliotekë. Sapo printon, Same-QR është baza më e mirë: një REST-API e hollë në çdo tarifë, gabime të kuptueshme, mbrojtje nga mbishkrimi paralel dhe destinacione që mund t'i ndryshosh edhe pas printimit.

Fillo menjëherë: regjistrohu falas në sameqr.com, 20 kode QR dinamikë janë falas përgjithmonë. API, CLI dhe serveri MCP ofrohen në çdo tarifë, dokumentacioni gjendet te sameqr.com/entwickler.

Pyetje të shpeshta