Pular para o conteúdo
qr3.app Docs

Primeiros passos

Primeiros passos

Você é novo no qr3.app? Esta visão geral guiará você pelos conceitos básicos em cerca de 5 minutos — quer você queira criar shortlinks dinâmicos, QR-Analytics ou um EU Digital Product Passport.

Caminho recomendado

  1. Introdução — O que é o qr3.app, quais produtos existem (Codes, DPPs, Resolver, Agent-Skills) e como a stack é estruturada.
  2. Início rápido — Passos com curl desde a primeira API-Key até o primeiro QR Code pronto, incluindo teste de redirecionamento.
  3. Autenticação — Criar API-Keys, definir cabeçalhos de Workspace, gerenciar secrets locais.
  4. SDKs, CLI & MCP — TypeScript-SDK, CLI (npx @qr3/cli) e o servidor MCP para AI-Agents.

Ir direto para o caso de uso

Criar QR Code dinâmico POST /v1/codes, verificação rápida de redirecionamento e primeiro evento de scan no painel.
Criar Digital Product Passport Bateria, têxtil e validador de conformidade da UE através da mesma API.
Imprimir QR-Asset (SVG/PDF/EPS) PDF vetorial (RGB), SVG, PNG e EPS em /v1/codes/:id/qr.*
Conectar AI-Agent (MCP) create_dpp_qr e outras ferramentas — diretamente do Claude, Cursor ou Codex.

O que você precisa ter em mãos

  • Uma conta em app.qr3.app/sign-up (Workspace de teste incluído).
  • Uma API-Key (Painel → Configurações → API-Keys) no formato qr3_sk_….
  • Para DPPs, adicionalmente um GTIN e um número de série/lote. Quem (ainda) não possui um GTIN próprio pode usar o modo interno BYO-GTIN (consulte GS1-Onboarding).

Ajuda e referências