Erste Schritte
Erste Schritte
Du bist neu bei qr3.app? Diese Übersicht führt dich in ca. 5 Minuten durch die Grundlagen — egal, ob du dynamische Shortlinks, QR-Analytics oder einen EU Digital Product Passport erzeugen möchtest.
Empfohlener Pfad
- Einführung — Was qr3.app ist, welche Produkte es gibt (Codes, DPPs, Resolver, Agent-Skills) und wie der Stack aufgebaut ist.
- Quickstart —
curl-Schritte vom ersten API-Key bis zum ersten fertigen QR-Code inklusive Redirect-Test. - Authentifizierung — API-Keys anlegen, Workspace-Header setzen, lokale Secrets verwalten.
- SDKs, CLI & MCP — TypeScript-SDK, CLI (
npx @qr3/cli) und der MCP-Server für AI-Agents.
Direkt zum passenden Use-Case
Dynamischen QR-Code anlegen POST /v1/codes, kurzer Redirect-Check und erstes Scan-Event im Dashboard.
Digital Product Passport erstellen Batterie, Textil und EU-Compliance-Validator über dieselbe API.
QR-Asset drucken (SVG/PDF/EPS) Vektor-PDF (RGB), SVG, PNG und EPS unter /v1/codes/:id/qr.*
AI-Agent verbinden (MCP) create_dpp_qr und weitere Tools — direkt aus Claude, Cursor oder Codex.
Was du griffbereit brauchst
- Einen Account unter app.qr3.app/sign-up (Test-Workspace inklusive).
- Ein API-Key (Dashboard → Einstellungen → API-Keys) in der Form
qr3_sk_…. - Für DPPs zusätzlich eine GTIN und eine Serien-/Chargen-Nummer. Wer (noch) keine eigene GTIN hat, nutzt den internen
BYO-GTIN-Modus (siehe GS1-Onboarding).
Hilfe & Referenzen
- API-Referenz — alle Endpoints mit Request-/Response-Beispielen.
- Interaktive OpenAPI — direkt im Browser ausprobieren, Authentifizierung wird im Frontmatter gespeichert.
- Fehler-Referenz — RFC-7807-Problem-Types mit Lösungshinweisen.
- Changelog — Release-Notes der öffentlichen API.