Prvi koraci
Prvi koraci
Novi ste na qr3.app? Ovaj pregled će vas provesti kroz osnove za oko 5 minuta — bez obzira želite li stvoriti dinamičke kratke poveznice, QR analitiku ili EU Digital Product Passport.
Preporučeni put
- Uvod — Što je qr3.app, koji proizvodi postoje (kodovi, DPP-ovi, Resolver, vještine agenata) i kako je stog strukturiran.
- Brzi početak —
curlkoraci od prvog API ključa do prvog gotovog QR koda uključujući test preusmjeravanja. - Autentifikacija — Izrada API ključeva, postavljanje zaglavlja radnog prostora (Workspace), upravljanje lokalnim tajnama (Secrets).
- SDK-ovi, CLI & MCP — TypeScript SDK, CLI (
npx @qr3/cli) i MCP poslužitelj za AI agente.
Izravno na odgovarajući slučaj upotrebe
Izrada dinamičkog QR koda POST /v1/codes, brza provjera preusmjeravanja i prvi događaj skeniranja na nadzornoj ploči.
Izrada Digital Product Passport-a Baterija, tekstil i EU validator usklađenosti putem istog API-ja.
Ispis QR imovine (SVG/PDF/EPS) Vektorski PDF (RGB), SVG, PNG i EPS pod /v1/codes/:id/qr.*
Povezivanje AI agenta (MCP) create_dpp_qr i drugi alati — izravno iz Claudea, Cursora ili Codexa.
Što vam je potrebno pri ruci
- Korisnički račun na app.qr3.app/sign-up (uključujući testni radni prostor).
- API ključ (Nadzorna ploča → Postavke → API ključevi) u obliku
qr3_sk_…. - Za DPP-ove dodatno GTIN i serijski broj / broj serije. Tko (još) nema vlastiti GTIN, koristi interni
BYO-GTINnačin rada (vidi GS1 Onboarding).
Pomoć i reference
- API referenca — sve krajnje točke s primjerima zahtjeva/odgovora.
- Interaktivni OpenAPI — isprobajte izravno u pregledniku, autentifikacija se sprema u frontmatter.
- Referenca pogrešaka — RFC-7807 vrste problema s uputama za rješavanje.
- Zapisnik promjena (Changelog) — bilješke o izdanju javnog API-ja.