Skip to content
qr3.app Docs

Бърз старт

Бърз старт

Създайте първия си QR код за по-малко от 5 минути.

Предварителни изисквания

1. Създаване на първия QR код

Terminal window
npm install @qr3/sdk
import { QR3 } from "@qr3/sdk";


const client = new QR3({ apiKey: "qr3_sk_your_key" });


const code = await client.codes.create({
  type: "url",
  url: "https://example.com",
  is_dynamic: true,
  notes: "Mein erster QR-Code",
});


console.log(code.short_url);  // https://qr3.app/r7f3Kx
console.log(code.images.svg); // SVG-URL für Druckanwendungen
console.log(code.images.png); // PNG-URL für digitale Medien

2. Използване на изображението на QR кода

Изображението е достъпно веднага на върнатия URL адрес:

<img src="https://qr3.app/v1/codes/qr_xxx/image?format=svg&size=300" alt="QR-Code" />

За печатни приложения препоръчваме SVG (векторно, без загуба на качество):

Terminal window
# SVG herunterladen
curl "https://qr3.app/v1/codes/qr_xxx/image?format=svg" -o qrcode.svg

3. Промяна на целевия URL адрес (динамично!)

Най-хубавото на динамичните QR кодове: можете да промените целта по всяко време — без да се налага да печатате нов код.

await client.codes.update("qr_xxx", {
  url: "https://new-destination.com",
});

4. Анализиране на сканиранията

const stats = await client.scans.stats("qr_xxx");
console.log(stats.total_scans);    // Gesamt-Scans
console.log(stats.by_country);     // Top-Länder
console.log(stats.by_device);      // Mobile vs. Desktop

Следващи стъпки