Prvi koraki
Prvi koraki
Ste novi pri qr3.app? Ta pregled vas bo v približno 5 minutah popeljal skozi osnove — ne glede na to, ali želite ustvariti dinamične kratke povezave, QR-analitiko ali EU Digital Product Passport.
Priporočena pot
- Uvod — Kaj je qr3.app, kateri izdelki so na voljo (Codes, DPPs, Resolver, Agent-Skills) in kako je sestavljen sklad.
- Hiter začetek — Koraki s
curlod prvega API-ključ do prve končane QR-kode, vključno s preizkusom preusmeritve. - Avtentikacija — Ustvarjanje API-ključev, nastavljanje glave Workspace, upravljanje lokalnih skrivnosti.
- SDK-ji, CLI in MCP — TypeScript-SDK, CLI (
npx @qr3/cli) in strežnik MCP za AI-Agents.
Neposredno do ustreznega primera uporabe
Ustvarjanje dinamične QR-kode POST /v1/codes, kratek preizkus preusmeritve in prvi dogodek skeniranja na nadzorni plošči.
Ustvarjanje Digital Product Passport Baterije, tekstil in EU-Compliance-Validator prek istega API-ja.
Tiskanje QR-sredstva (SVG/PDF/EPS) Vektorski PDF (RGB), SVG, PNG in EPS na /v1/codes/:id/qr.*
Povezovanje AI-Agenta (MCP) create_dpp_qr in druga orodja — neposredno iz Claude, Cursor ali Codex.
Kaj potrebujete pri roki
- Račun na app.qr3.app/sign-up (vključno s testnim delovnim prostorom Workspace).
- API-ključ (Nadzorna plošča → Nastavitve → API-Keys) v obliki
qr3_sk_…. - Za DPP-je dodatno GTIN in serijsko številko ali številko serije. Tisti, ki (še) nimate lastne GTIN, uporabite interni način
BYO-GTIN(glejte GS1-Onboarding).
Pomoč in reference
- API-referenca — vsi končni točki s primeri zahtev in odgovorov.
- Interaktivni OpenAPI — preizkusite neposredno v brskalniku, avtentikacija se shrani v frontmatter.
- Referenca napak — RFC-7807-Problem-Types z navodili za reševanje.
- Dnevnik sprememb — opombe ob izdaji javnega API-ja.