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, nukreipimo įrankiai (Resolver), agentų įgūdžiai) ir kaip sudaryta technologijų grupė (Stack).
- 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 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 validatorius 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į).
- 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, autentifikavimas išsaugomas frontmatter.
- Klaidų žinynas — RFC-7807 problemų tipai su sprendimo patarimais.
- Changelog — viešosios API versijų išleidimo pastabos.