Aloittaminen
Aloittaminen
Oletko uusi qr3.app-palvelussa? Tämä yleiskatsaus vie sinut noin 5 minuutissa perusasioiden läpi — halusitpa sitten luoda dynaamisia lyhytlinkkejä, QR-analytiikkaa tai EU:n digitaalisen tuotepassin (DPP).
Suositeltu polku
- Johdanto — Mikä qr3.app on, mitä tuotteita on saatavilla (koodit, DPP:t, selvitysratkaisut, Agent-taidot) ja miten pino on rakennettu.
- Pikaopas —
curl-vaiheet ensimmäisestä API-avaimesta ensimmäiseen valmiiseen QR-koodiin ja uudelleenohjaustestiin. - Todennus — API-avainten luominen, työtilan otsikoiden asettaminen ja paikallisten salaisuuksien hallinta.
- SDK:t, CLI & MCP — TypeScript-SDK, CLI (
npx @qr3/cli) ja MCP-palvelin tekoälyagenteille.
Suoraan käyttötapaukseen
Dynaamisen QR-koodin luominen POST /v1/codes, nopea uudelleenohjaustesti ja ensimmäinen skannaustapahtuma hallintapaneelissa.
Digitaalisen tuotepassin luominen Akku-, tekstiili- ja EU-vaatimustenmukaisuuden validaattori saman API:n kautta.
QR-resurssin tulostaminen (SVG/PDF/EPS) Vektori-PDF (RGB), SVG, PNG ja EPS osoitteesta /v1/codes/:id/qr.*
Tekoälyagentin yhdistäminen (MCP) create_dpp_qr ja muut työkalut — suoraan Claudesta, Cursorista tai Codexista.
Mitä tarvitset valmiiksi
- Tili osoitteessa app.qr3.app/sign-up (sisältää testityötilan).
- API-avain (Hallintapaneeli → Asetukset → API-avaimet) muodossa
qr3_sk_…. - DPP-passeja varten lisäksi GTIN ja sarja-/eränumero. Jos sinulla ei (vielä) ole omaa GTIN-koodia, käytä sisäistä
BYO-GTIN-tilaa (katso GS1-käyttöönotto).
Apu & viitteet
- API-viite — kaikki päätepisteet pyyntö- ja vastausesimerkkeineen.
- Interaktiivinen OpenAPI — kokeile suoraan selaimessa, todennus tallennetaan frontmatteriin.
- Virheviite — RFC-7807-virhetyypit ja ratkaisuohjeet.
- Muutosloki — julkisen API:n julkaisutiedot.