API za QR kodove: automatski pravi, menjaj i analiziraj QR kodove

Čemu služi API za QR kodove

API za QR kodove je programski interfejs: umesto da klikćeš u pregledaču, tvoj program šalje zahteve servisu za QR kodove i dobija odgovore. Tako QR kodovi nastaju direktno iz prodavnice, softvera za robno poslovanje, skripte ili tabele.

To se isplati čim se posao ponavlja: sto QR kodova za stolove ili proizvode, mesečni izveštaji o skeniranjima, prebacivanje mnogih odredišta posle redizajna sajta. A radi samo sa dinamičkim QR kodovima. Dinamički QR kod Same-QR sadrži kratku adresu koja se ne menja, odredište iza nje je kod nas i može da se promeni u svakom trenutku, bez nove štampe.

Šta pokriva Same-QR API

REST API je na https://sameqr.com/api/v1. Poziva iste funkcije kao kontrolna tabla, sa istim ograničenjima paketa i proverama:

• Izlistavanje, čitanje, pravljenje, menjanje i brisanje QR kodova.
• Statistika QR koda: skeniranja, datum pravljenja, broj promena odredišta.
• Pravljenje, menjanje, objavljivanje i skidanje sa interneta gostinskih stranica kao što su jelovnik, cenovnik, radno vreme, stranica sa linkovima, akcija, vinarija, E-etiketa vina i kontakt.
• Učitavanje jelovnika iz do sedam fotografija ili jednog PDF-a.
• Upravljanje oznakama i projektima klijenata i čitanje upita iz kontakt obrazaca.

Mašinski čitljiv opis svih zahteva je na /api/v1/openapi.json, uputstvo na sameqr.com/entwickler.

API ključ i prava

Ključ praviš na kontrolnoj tabli pod Nalog, u odeljku „Pristup za CLI, skripte i agente“. Biraš jedan od tri nivoa, „samo čitanje“, „čitanje + pisanje“ (pravljenje, menjanje imena i tekstova) ili „potpuno“ (dodatno menjanje odredišta, skidanje sa interneta, brisanje), i rok važenja od 30, 90, 180 ili 365 dana, po potrebi i neograničeno. Ključ počinje sa sqr_live_ i prikazuje se tačno jednom. Kod nas se čuva samo kontrolni zbir.

Ključ koji sme samo da čita dobija jasno odbijanje na svaki zahtev koji nešto menja. Za izveštaje i analize to je pravi izbor. Sve što menja kuda vodi odštampani QR kod dodatno je zaštićeno: promene odredišta, skidanje sa interneta i brisanje traže nivo „potpuno“ i potvrdu sa prethodno pročitanim stanjem, a preko API-ja je od toga dozvoljeno najviše 10 na sat i 30 na dan. Na kontrolnoj tabli ovog ograničenja nema. Svaki ključ možeš da opozoveš u svakom trenutku i on odmah postaje nevažeći.

Tipičan tok

Ključ ide u zaglavlje Authorization, nikad u adresu. Ključ prethodno sačuvaj kao promenljivu okruženja. Ovako izlistavaš svoje QR kodove i menjaš odredište jednog QR koda:

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"}'

Vrednost za X-Confirm, stanje, daje zahtev za čitanje na /api/v1/qr/<id>. Menja se samo ono što pošalješ. Ko želi da bude siguran da niko u međuvremenu nije promenio isti QR kod, šalje pročitano stanje kao _rev. Ako se nešto promenilo, ništa se ne prepisuje, a odgovor sadrži aktuelno stanje. Greške uvek stižu u istom formatu, sa statusom, QR kodom i razumljivom porukom.

Ograničenja i dobra praksa

Po ključu je dozvoljeno najviše 120 zahteva u minuti. Uz to postoji ograničenje po satu koje zavisi od paketa: 60 u besplatnom paketu, 300 u paketu Start, 1.000 u paketu Pro i 5.000 u paketu Agentur. Ograničenja hvataju greške, na primer skriptu u beskonačnoj petlji, a poštenu upotrebu ne ometaju.

• Prvo isprobaj sa ključem za čitanje, pa tek onda piši.
• Nove tokove testiraj na jednom QR kodu i skeniraj ga telefonom.
• Izbegavaj brisanje tamo gde je dovoljno novo odredište. Obrisani QR kodovi i njihovi kratki linkovi ne vraćaju se.
• Za svaki program napravi poseban ključ i čuvaj ga u menadžeru lozinki ili u promenljivoj okruženja.

Zaključak: zašto Same-QR

Same-QR ti ne daje API kao skupi dodatak, nego u svakom paketu, sa istim funkcijama kao kontrolna tabla: QR kodovi, statistika, jelovnici, gostinske stranice, oznake i projekti. Tome se dodaju jasna prava po ključu, iskrene poruke o greškama i noćna provera svih odredišta koja ti mejlom javlja ako neko od njih nije dostupno.

Kreni odmah: registruj se besplatno na sameqr.com, 20 dinamičkih QR kodova je trajno besplatno. API, CLI i MCP server postoje u svakom paketu, dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja