Pierwsze kroki
Pierwsze kroki
Jesteś nowy w qr3.app? Ten przegląd przeprowadzi Cię w około 5 minut przez podstawy — niezależnie od tego, czy chcesz tworzyć dynamiczne shortlinki, analitykę QR, czy cyfrowy paszport produktu (EU Digital Product Passport).
Zalecana ścieżka
- Wprowadzenie — Czym jest qr3.app, jakie produkty są dostępne (kody, DPP, resolvery, skille agentów) i jak zbudowany jest stos technologiczny.
- Quickstart — Kroki z użyciem
curlod pierwszego klucza API do pierwszego gotowego kodu QR wraz z testem przekierowania. - Uwierzytelnianie — Tworzenie kluczy API, ustawianie nagłówków workspace, zarządzanie lokalnymi sekretami.
- SDK, CLI & MCP — TypeScript-SDK, CLI (
npx @qr3/cli) i serwer MCP dla agentów AI.
Przejdź bezpośrednio do odpowiedniego przypadku użycia
Utwórz dynamiczny kod QR POST /v1/codes, szybki test przekierowania i pierwsze zdarzenie skanowania w panelu.
Utwórz Digital Product Passport Baterie, tekstylia i walidator zgodności z przepisami UE za pośrednictwem tego samego API.
Wydrukuj zasób QR (SVG/PDF/EPS) Wektorowy PDF (RGB), SVG, PNG i EPS pod adresem /v1/codes/:id/qr.*
Połącz agenta AI (MCP) create_dpp_qr i inne narzędzia — bezpośrednio z Claude, Cursor lub Codex.
Co musisz mieć pod ręką
- Konto na stronie app.qr3.app/sign-up (zawiera testowy workspace).
- Klucz API (Panel → Ustawienia → Klucze API) w formacie
qr3_sk_…. - Dla DPP dodatkowo GTIN oraz numer seryjny/partii. Jeśli (jeszcze) nie posiadasz własnego GTIN, użyj wewnętrznego trybu
BYO-GTIN(zobacz Wdrożenie GS1).
Pomoc i referencje
- Dokumentacja API — wszystkie punkty końcowe z przykładami żądań i odpowiedzi.
- Interaktywne OpenAPI — wypróbuj bezpośrednio w przeglądarce, uwierzytelnianie jest zapisywane w frontmatter.
- Dokumentacja błędów — typy problemów zgodne z RFC-7807 wraz ze wskazówkami dotyczącymi rozwiązań.
- Dziennik zmian (Changelog) — informacje o wydaniach publicznego API.