Skip to content
qr3.app Docs

Първи стъпки

Първи стъпки

Нови сте в qr3.app? Този общ преглед ще ви преведе през основите за около 5 минути — независимо дали искате да създавате динамични кратки връзки (shortlinks), QR анализи или Дигитален продуктов паспорт на ЕС (EU Digital Product Passport).

Препоръчителен път

  1. Въведение — Какво е qr3.app, какви продукти се предлагат (кодове, DPP, Resolver, Agent-Skills) и как е изграден стекът.
  2. Бърз старт — стъпки с curl от първия API ключ до първия готов QR код, включително тест за пренасочване.
  3. Автентификация — създаване на API ключове, задаване на заглавки на работното пространство (Workspace-Header), управление на локални тайни (Secrets).
  4. SDK, CLI & MCP — TypeScript SDK, CLI (npx @qr3/cli) и MCP сървър за AI агенти.

Директно към подходящия случай на употреба

Създаване на динамичен QR код POST /v1/codes, бърза проверка на пренасочването и първо събитие за сканиране в таблото за управление.
Създаване на Дигитален продуктов паспорт Батерии, текстил и валидатор за съответствие с ЕС чрез същия API.
Печат на QR ресурс (SVG/PDF/EPS) Векторен PDF (RGB), SVG, PNG и EPS на адрес /v1/codes/:id/qr.*
Свързване на AI агент (MCP) create_dpp_qr и други инструменти — директно от Claude, Cursor или Codex.

Какво ви е необходимо под ръка

  • Акаунт на адрес app.qr3.app/sign-up (включително тестов Workspace).
  • API ключ (Табло за управление → Настройки → API ключове) във формат qr3_sk_….
  • За DPP допълнително GTIN и сериен номер/номер на партида. Тези, които (все още) нямат собствен GTIN, могат да използват вътрешния режим BYO-GTIN (вижте GS1 онбординг).

Помощ и справочници