Primi passi

Non conosci ancora qr3.app? Questa panoramica ti guiderà attraverso i concetti fondamentali in circa 5 minuti — sia che tu voglia creare shortlink dinamici, QR-Analytics o un EU Digital Product Passport.

Percorso consigliato

Introduzione — Cos’è qr3.app, quali prodotti sono disponibili (codici, DPP, Resolver, Agent-Skills) e come è strutturato lo stack.
Quickstart — Passaggi curl dalla prima API-Key al primo codice QR pronto, incluso il test di reindirizzamento.
Autenticazione — Creare API-Keys, impostare gli header del Workspace, gestire i secret locali.
SDK, CLI & MCP — SDK TypeScript, CLI (npx @qr3/cli) e il server MCP per AI-Agents.

Vai direttamente al tuo caso d’uso

Creare un codice QR dinamico POST /v1/codes, rapido controllo del reindirizzamento e primo evento di scansione nella dashboard.

Creare un Digital Product Passport Batterie, tessili e validatore di conformità UE tramite la stessa API.

Stampare asset QR (SVG/PDF/EPS) PDF vettoriale (RGB), SVG, PNG ed EPS sotto /v1/codes/:id/qr.*

Connettere un AI-Agent (MCP) create_dpp_qr e altri strumenti — direttamente da Claude, Cursor o Codex.

Cosa ti serve a portata di mano

Un account su app.qr3.app/sign-up (Workspace di test incluso).
Una API-Key (Dashboard → Impostazioni → API-Keys) nel formato qr3_sk_….
Per i DPP, inoltre, una GTIN e un numero di serie/lotto. Chi non ha (ancora) una propria GTIN può utilizzare la modalità interna BYO-GTIN (vedi Onboarding GS1).

Aiuto e riferimenti

Riferimento API — tutti gli endpoint con esempi di richiesta/risposta.
OpenAPI interattiva — provala direttamente nel browser, l’autenticazione viene salvata nel frontmatter.
Riferimento errori — Problem-Types RFC-7807 con suggerimenti per la risoluzione.
Changelog — note di rilascio dell’API pubblica.