--- title: "QR-koodid arendajatele: REST API, SDK ja CLI — qr3.app Blog" description: "Kuidas genereerida QR-koode programmaatiliselt, integreerida need oma rakendusse ja reageerida skannimistele veebihookide kaudu — tehniline süvaülevaade." canonical: "https://qr3.app/et/blog/qr-codes-for-developers/" lang: "et" robots: "index,follow,max-image-preview:large,max-snippet:-1" --- # QR-koodid arendajatele: REST API, SDK ja CLI — qr3.app Blog > Kuidas genereerida QR-koode programmaatiliselt, integreerida need oma rakendusse ja reageerida skannimistele veebihookide kaudu — tehniline süvaülevaade. Canonical: [← Blogi](/et/blog/) [Õpetused](/et/blog/category/tutorials/) 8. märts 2026 8 min lugemist [Õpetused](/et/blog/category/tutorials/) [API](/et/blog/tag/API/)[SDK](/et/blog/tag/SDK/)[Developer](/et/blog/tag/Developer/)[Webhooks](/et/blog/tag/Webhooks/) # QR-koodid arendajatele: REST API, SDK ja CLI Kuidas genereerida QR-koode programmaatiliselt, integreerida need oma rakendusse ja reageerida skannimistele veebihookide kaudu — tehniline süvaülevaade. autor **qr3.app Team** ![QR-koodid arendajatele: REST API, SDK ja CLI](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/qr-codes-for-developers/hero.png) Arendajana ei taha sa luua QR-koode käsitsi armatuurlaua kaudu — sa tahad neid genereerida automaatselt, integreerida oma ehituskonveierisse ja reageerida skannimistele veebihookide kaudu. Just selleks qr3.app loodudki on. ## Tehnoloogiapakk qr3.app on täielikult Cloudflare-natiivne: - **API Worker**: Hono Cloudflare Workersil (V8 runtime, ilma ühegi Node.js sõltuvuseta) - **Redirect Worker**: ülikerge worker, KV-vahemällu salvestatud ümbersuunamised alla 5 ms p50 juures - **Andmebaas**: Cloudflare D1 (SQLite) mitme rentniku toega `workspace_id` kaudu - **Järjekord**: skannimissündmused on lahti seotud Cloudflare Queues abil ## Autentimine Kõik API-päringud nõuavad Bearer-tokenit ja tööruumi ID-d: ``` POST https://qr3.app/v1/codes Authorization: Bearer qr3_sk_... Content-Type: application/json ``` Loo API-võtmed aadressil [app.qr3.app/dashboard/api-keys](https://app.qr3.app/dashboard/api-keys). ## TypeScripti SDK ``` npm install @qr3/sdk # või pnpm add @qr3/sdk ``` ``` import { QR3 } from "@qr3/sdk"; const client = new QR3({ apiKey: process.env.QR3_API_KEY!, workspaceId: process.env.QR3_WORKSPACE_ID!, }); // Create a QR code const { data: code } = await client.codes.create({ type: "url", url: "https://my-shop.com/product/42", title: "Product 42", tags: ["shop", "product"], }); console.log(code.short_code); // "r7f3Kx" console.log(code.image_svg_url); // SVG image URL console.log(code.redirect_url); // https://qr3.app/r7f3Kx // Change URL later (dynamic codes only) await client.codes.update(code.id, { url: "https://my-shop.com/product/42-new", }); // Query analytics const stats = await client.codes.stats(code.id, { from: "2026-01-01", to: "2026-03-31", }); console.log(stats.data.total_scans); // e.g. 1247 ``` ## REST API otse Kas SDK-sõltuvust pole? REST API on otse kasutatav: ``` # Create a QR code curl -X POST https://qr3.app/v1/codes \ -H "Authorization: Bearer $QR3_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "url", "url": "https://my-site.com", "title": "My Site", "is_dynamic": true }' # List all QR codes curl https://qr3.app/v1/codes?limit=20 \ -H "Authorization: Bearer $QR3_API_KEY" # Upload a logo — embedded automatically in SVG and PNG from here on curl -X POST https://qr3.app/v1/codes/qr_abc123/logo \ -H "Authorization: Bearer $QR3_API_KEY" \ -F "file=@logo.png" # Download QR code as SVG (now includes the logo) curl "https://qr3.app/v1/codes/r7f3Kx/qr.svg?size=8" \ -o qrcode.svg ``` ## CLI Skriptimiseks ja CI/CD jaoks on olemas `@qr3/cli`: ``` npm install -g @qr3/cli qr3 login # Create QR code and save as SVG qr3 codes create --url "https://my-site.com" --title "CI Deploy" --output qr.svg # Batch creation from CSV qr3 codes batch import urls.csv --format svg --output ./qr-codes/ ``` ## Veebihookid: reageeri skannimistele Veebihookid on kõige võimsam funktsioon: sa saad reaalajas reageerida igale skannimisele. ``` // Register a webhook const { data: webhook } = await client.webhooks.create({ url: "https://your-app.com/webhooks/qr3", events: ["qr.scanned", "qr.updated"], }); ``` ### Veebihooki andmepakett ``` { "id": "evt_4f0c2a91d7e84b3c9a1f", "type": "qr.scanned", "created": "2026-03-15T14:30:00.000Z", "data": { "code_id": "qr_abc123", "short_code": "r7f3Kx", "scanned_at": "2026-03-15T14:30:00.000Z", "country": "DE", "device_type": "mobile", "os": "iOS", "browser": "Safari", "language": "de", "ab_variant": null, "redirected_to": "https://example.com/landing" } } ``` ### Veebihookide verifitseerimine (HMAC) ``` import { createHmac, timingSafeEqual } from "crypto"; export async function verifyWebhook( payload: string, signature: string, secret: string, ): Promise { const expected = createHmac("sha256", secret) .update(payload) .digest("hex"); const expectedBytes = Buffer.from(`sha256=${expected}`); const receivedBytes = Buffer.from(signature); return ( expectedBytes.length === receivedBytes.length && timingSafeEqual(expectedBytes, receivedBytes) ); } ``` ## Päringusageduse piiramine Iga API-võti võib saata 60 päringut minutis, seda iga paketi puhul. Koodide loomisel kehtib lisaks töölauapõhine päevalimiit, mis on samuti kõigi pakettide puhul sama: `POST /v1/codes` võtab vastu uusi koode, kuni sel päeval on loodud 200 koodi, `POST /v1/codes/batch` kuni 10 000 koodi. Iga autentitud vastus sisaldab päist `X-RateLimit-Limit`. Vastus koodiga `429` näitab lisaks ka aega, millal uuesti proovida: ``` X-RateLimit-Limit: 60 X-RateLimit-Remaining: 0 X-RateLimit-Reset: 1710510060 Retry-After: 60 ``` ## Veavorming (RFC 7807) Kõik vead järgivad [RFC 7807 Problem Details](https://www.rfc-editor.org/rfc/rfc7807) standardit: ``` { "type": "https://docs.qr3.app/errors/validation", "title": "Validation Error", "status": 422, "detail": "url is required for type 'url'", "errors": [ { "field": "url", "message": "Required" } ] } ``` ## Kokkuvõte qr3.app on algusest peale ehitatud arendajatööriistaks: avatud REST API, TypeScript-eelistusega SDK, CLI, veebihookid ja täielik OpenAPI dokumentatsioon. Tutvu [API dokumentatsiooniga](https://docs.qr3.app/en/api/) või alusta [armatuurlaual](https://app.qr3.app/dashboard). [← Kõik artiklid](/et/blog/) [Alusta tasuta](https://app.qr3.app/sign-up)