Първи стъпки
Първи стъпки
Нови сте в qr3.app? Този преглед ще ви преведе през основите за около 5 минути — независимо дали искате да създавате динамични кратки връзки, QR анализи или Дигитален продуктов паспорт (DPP) на ЕС.
Препоръчителен път
- Въведение — Какво е qr3.app, какви продукти се предлагат (кодове, DPP, Resolver, Agent-Skills) и как е изграден технологичният стек.
- Бърз старт — стъпки с
curlот първия API-Key до първия готов QR код, включително тест за пренасочване. - Автентификация — създаване на API-Keys, задаване на заглавки за работно пространство (Workspace-Header), управление на локални тайни (Secrets).
- SDK, CLI & MCP — TypeScript-SDK, CLI (
npx @qr3/cli) и MCP сървър за AI-Agents.
Директно към подходящия случай на употреба
Създаване на динамичен QR код POST /v1/codes, бърза проверка на пренасочването и първо сканиране в таблото (Dashboard).
Създаване на Дигитален продуктов паспорт Батерии, текстил и валидатор за съответствие с изискванията на ЕС чрез същия API.
Печат на QR ресурс (SVG/PDF/EPS) Векторен PDF (RGB), SVG, PNG und EPS на адрес /v1/codes/:id/qr.*
Свързване на AI-Agent (MCP) create_dpp_qr и други инструменти — директно от Claude, Cursor или Codex.
Какво ви е необходимо под ръка
- Акаунт на адрес app.qr3.app/sign-up (включително тестов Workspace).
- API-Key (Dashboard → Настройки → API-Keys) във формат
qr3_sk_…. - За DPP допълнително GTIN и сериен номер/номер на партида. Тези, които (все още) нямат собствен GTIN, могат да използват вътрешния режим
BYO-GTIN(вижте GS1-Onboarding).
Помощ и справочници
- API Справочник — всички крайни точки (Endpoints) с примери за заявки и отговори.
- Интерактивен OpenAPI — изпробвайте директно в браузъра, автентификацията се запазва във frontmatter.
- Справочник за грешки — RFC-7807 Problem-Types с насоки за разрешаване.
- Changelog — бележки по версиите (Release-Notes) на публичния API.