API e kodit QR: krijo, ndrysho dhe vlerëso kodet QR automatikisht

Për çfarë shërben një API e kodit QR

Një API e kodit QR është një ndërfaqe programimi: në vend që të klikosh në shfletues, programi yt dërgon kërkesa te shërbimi i kodit QR dhe merr përgjigje. Kështu kodet QR krijohen direkt nga një dyqan, një sistem magazine, një skript ose një tabelë.

Kjo bën dobi sapo puna përsëritet: njëqind kode QR për tavolina ose produkte, raporte mujore të skanimeve, ndërrimi i shumë destinacioneve pas një rindërtimi. Dhe funksionon vetëm me kode QR dinamikë. Një kod QR dinamik i Same-QR përmban një adresë të shkurtër dhe të qëndrueshme, destinacioni pas saj ndodhet te ne dhe mund të ndryshohet kurdo, pa printuar sërish.

Çfarë mbulon API e Same-QR

API REST ndodhet te https://sameqr.com/api/v1. Ajo thërret të njëjtat funksione si paneli, me të njëjtat kufij të planit dhe të njëjtat kontrolle:

• Rendit, lexo, krijo, ndrysho dhe fshi kode QR.
• Statistikën e një kodi QR: skanimet, datën e krijimit, numrin e ndryshimeve të destinacionit.
• Krijo, ndrysho, publiko dhe hiq offline faqe për mysafirë si menyja, lista e çmimeve, orari i punës, faqja me lidhje, oferta, vreshti, etiketa elektronike e verës dhe kontakti.
• Lexo një meny nga deri në shtatë foto ose nga një PDF.
• Administro etiketat dhe projektet e klientëve dhe lexo kërkesat nga format e kontaktit.

Një përshkrim i lexueshëm nga makinat i të gjitha kërkesave ndodhet te /api/v1/openapi.json, udhëzuesi te sameqr.com/entwickler.

Çelësat e API dhe të drejtat

Çelësin e krijon në panel te Llogaria, pjesa „Qasje për CLI, skripte dhe agjentë“. Zgjedh një nga tri nivelet, „vetëm lexim“, „lexim + shkrim“ (krijim, ndryshim emrash dhe tekstesh) ose „i plotë“ (shtesë ndryshim destinacionesh, heqje offline, fshirje), dhe një kohëzgjatje 30, 90, 180 ose 365 ditë, nëse duhet edhe pa kufi. Çelësi fillon me sqr_live_ dhe shfaqet vetëm një herë. Te ne ruhet vetëm një shumë kontrolli.

Një çelës që lejohet vetëm të lexojë merr një refuzim të qartë në çdo kërkesë që ndryshon diçka. Për raporte dhe vlerësime kjo është zgjedhja e duhur. Gjithçka që ndryshon ku të çon një kod QR i printuar mbrohet edhe më shumë: ndryshimet e destinacionit, heqja offline dhe fshirja kërkojnë nivelin „i plotë“ dhe një konfirmim me gjendjen e lexuar më parë, dhe përmes API kalojnë më së shumti 10 në orë dhe 30 në ditë. Në panel ky kufi nuk ekziston. Çdo çelës mund të anulohet kurdo dhe pastaj është menjëherë i pavlefshëm.

Një rrjedhë tipike

Çelësi vendoset në header-in Authorization, kurrë në një adresë. Çelësin e ruan më parë si variabël mjedisi. Kështu i rendit kodet e tua QR dhe ndryshon destinacionin e një kodi QR:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

curl -X PATCH https://sameqr.com/api/v1/qr/<id> \
  -H "Authorization: Bearer $SAMEQR_API_KEY" -H "Content-Type: application/json" \
  -H "X-Confirm: <stand>" \
  -d '{"targetUrl":"https://example.com/karte-neu"}'

Vlerën për X-Confirm, gjendjen, e jep kërkesa e leximit te /api/v1/qr/<id>. Ndryshon vetëm ajo që dërgon. Kush dëshiron të jetë i sigurt që askush nuk e ka ndryshuar ndërkohë të njëjtin kod QR, dërgon gjendjen e lexuar si _rev. Nëse diçka ka ndryshuar, nuk mbishkruhet asgjë dhe përgjigjja përmban gjendjen aktuale. Gabimet kthehen gjithmonë në të njëjtin format, me status, kod QR dhe një mesazh të kuptueshëm.

Kufijtë dhe praktika e mirë

Për çdo çelës lejohen më së shumti 120 kërkesa në minutë. Shtohet një kufi për çdo orë që varet nga plani: 60 në planin falas, 300 në Start, 1.000 në Pro dhe 5.000 në Agentur. Kufijtë kapin gabimet, për shembull një skript në ciklin e pafund, dhe nuk e prekin përdorimin e ndershëm.

• Provo së pari me një çelës leximi, pastaj shkruaj.
• Testo rrjedhat e reja te një kod i vetëm QR dhe skanoje me telefon.
• Shmang fshirjen aty ku mjafton një destinacion i ri. Kodet QR të fshirë dhe lidhjet e tyre të shkurtra nuk kthehen.
• Krijo një çelës të veçantë për çdo program dhe mbaje në një menaxher fjalëkalimesh ose në një variabël mjedisi.

Përfundim: pse Same-QR

Same-QR nuk ta jep API-n si shtesë të shtrenjtë, por në çdo plan, me të njëjtat funksione si në panel: kode QR, statistikë, menytë, faqet e mysafirëve, etiketat dhe projektet. Shtohen të drejta të qarta për çdo çelës, mesazhe gabimi të ndershme dhe një kontroll i natës i të gjitha destinacioneve që të njofton me email kur njëri nuk arrihet.

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

Pyetje të shpeshta