REST API

Manage API keys and integrate DinamikQR. Base URL: https://dynamic-qr-code.ru

Authentication

Send Authorization: Bearer YOUR_KEY on every request. Keys are created below (Pro / Business plans).

curl -H "Authorization: Bearer YOUR_KEY" \
  https://dynamic-qr-code.ru/api/v1/qr

GET /api/v1/qr

List QR codes for the authenticated account.

Response 200
{
  "data": [
    {
      "id": "...",
      "slug": "promo",
      "name": "My QR",
      "scans": 12,
      "destination": "https://example.com",
      "status": "active",
      "createdAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}

POST /api/v1/qr

Create a QR. Dynamic codes require an active plan or QR credit. Static codes do not.

Request
{
  "name": "My QR",
  "isDynamic": true,
  "contentType": "url",
  "destination": "https://example.com",
  "payload": "https://example.com",
  "design": { /* optional design object */ },
  "linkPassword": "optional",
  "meta": { "customSlug": "promo" }
}

Response 201 — { "data": { /* QR record */ } }

Errors
401 Unauthorized
403 NO_PLAN_OR_CREDITS | QR_LIMIT_REACHED | SCAN_LIMIT_REACHED
400 Bad request

GET /api/v1/stats

Aggregated scan statistics across your QR codes.

Response 200
{
  "data": {
    "totalQrcodes": 3,
    "totalScans": 128,
    "scansByDay": { "2026-07-01": 10 },
    "deviceSplit": { "mobile": 90, "desktop": 38 }
  }
}

API keys

Custom domains

Add a hostname, create a CNAME to dynamic-qr-code.ru or a TXT record dinamikqr-verify=…, then click Verify. Short links: yourdomain.com/slug