Első lépések

Új vagy a qr3.app oldalon? Ez az áttekintés kb. 5 perc alatt végigvezet az alapokon — függetlenül attól, hogy dinamikus rövid linkeket, QR-analitikát vagy EU Digital Product Passport-ot (DPP) szeretnél létrehozni.

Javasolt útvonal

Bevezetés — Mi az a qr3.app, milyen termékek léteznek (Codes, DPPs, Resolver, Agent-Skills), és hogyan épül fel a stack.
Gyorsútmutató — curl lépések az első API-Key-től az első kész QR-kódig, beleértve az átirányítási tesztet is.
Hitelesítés — API-Keys létrehozása, Workspace-fejlécek beállítása, helyi titkok (Secrets) kezelése.
SDK-k, CLI & MCP — TypeScript-SDK, CLI (npx @qr3/cli) és az MCP-szerver AI-Agents számára.

Közvetlenül a megfelelő használati esethez

Dinamikus QR-kód létrehozása POST /v1/codes, gyors átirányítás-ellenőrzés és az első beolvasási esemény a Dashboardon.

Digital Product Passport létrehozása Akkumulátor, textil és EU-megfelelőségi ellenőrző (Validator) ugyanazon az API-n keresztül.

QR-eszköz nyomtatása (SVG/PDF/EPS) Vektoros PDF (RGB), SVG, PNG és EPS a /v1/codes/:id/qr.* címen.

AI-Agent csatlakoztatása (MCP) create_dpp_qr és további eszközök — közvetlenül Claude, Cursor vagy Codex környezetből.

Amire szükséged lesz

Egy fiók a app.qr3.app/sign-up oldalon (teszt Workspace-szel együtt).
Egy API-Key (Dashboard → Beállítások → API-Keys) qr3_sk_… formátumban.
DPP-k esetén ezen felül egy GTIN és egy sorozat-/sarzs-szám. Akinek (még) nincs saját GTIN azonosítója, az a belső BYO-GTIN módot használhatja (lásd: GS1-Onboarding).

Súgó és hivatkozások

API-referencia — az összes végpont kérés/válasz példákkal.
Interaktív OpenAPI — kipróbálás közvetlenül a böngészőben, a hitelesítés a frontmatterben mentődik.
Hiba-referencia — RFC-7807 problématípusok megoldási javaslatokkal.
Changelog — a nyilvános API verziófrissítési jegyzékei (Release Notes).