Darbo pradžia
Darbo pradžia
Esate naujas qr3.app naudotojas? Ši apžvalga per maždaug 5 minutes supažindins jus su pagrindais — nesvarbu, ar norite kurti dinamines trumpąsias nuorodas, QR analitiką, ar ES skaitmeninį produkto pasą (DPP).
Rekomenduojamas kelias
- Įvadas — Kas yra qr3.app, kokie produktai siūlomi (kodai, DPP, Resolver, Agent-Skills) und wie der Stack aufgebaut ist.
- Greitasis startas —
curlžingsniai nuo pirmojo API rakto iki pirmojo paruošto QR kodo, įskaitant nukreipimo testą. - Autentifikavimas — API raktų kūrimas, Workspace antraščių nustatymas, vietinių paslapčių (Secrets) valdymas.
- SDK, CLI ir MCP — TypeScript SDK, CLI (
npx @qr3/cli) ir MCP serveris, skirtas AI agentams.
Tiesiai prie tinkamo naudojimo atvejo
Sukurti dinaminį QR kodą POST /v1/codes, trumpas nukreipimo patikrinimas ir pirmasis nuskaitymo įvykis valdymo skydelyje.
Sukurti skaitmeninį produkto pasą (DPP) Baterijų, tekstilės ir ES atitikties tikrinimo įrankis (Validator) per tą pačią API.
Spausdinti QR išteklių (SVG/PDF/EPS) Vektorinis PDF (RGB), SVG, PNG ir EPS adresu /v1/codes/:id/qr.*
Prijungti AI agentą (MCP) create_dpp_qr ir kiti įrankiai — tiesiai iš Claude, Cursor arba Codex.
Ko jums prireiks po ranka
- Paskyros adresu app.qr3.app/sign-up (įskaitant bandomąją darbo sritį (Workspace)).
- API rakto (Valdymo skydelis → Nustatymai → API raktai), kurio formatas
qr3_sk_…. - DPP atveju papildomai reikės GTIN ir serijos / partijos numerio. Tie, kurie (dar) neturi savo GTIN, naudoja vidinį
BYO-GTINrežimą (žr. GS1 integracija).
Pagalba ir nuorodos
- API nuorodos — visi pabaigos taškai (Endpoints) su užklausų ir atsakymų pavyzdžiais.
- Interaktyvi OpenAPI — išbandykite tiesiai naršyklėje, autentifikavimo duomenys išsaugomi puslapio nustatymuose (Frontmatter).
- Klaidų žinynas — RFC-7807 problemų tipai su sprendimo būdais.
- Pakeitimų žurnalas (Changelog) — viešosios API versijų išleidimo pastabos.