Документация Static QR API

curl -X GET https://api.webqr.io/v1/usage \
  -H "X-API-Key: wq_xxxxxxxxxx_your_secret"

<?php
$ch = curl_init('https://api.webqr.io/v1/usage');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'X-API-Key: wq_xxxxxxxxxx_your_secret',
  ],
]);
echo curl_exec($ch);

const res = await fetch('https://api.webqr.io/v1/usage', {
  headers: {
    'X-API-Key': 'wq_xxxxxxxxxx_your_secret',
  },
});
const data = await res.json();
console.log(data);

import requests

r = requests.get(
  "https://api.webqr.io/v1/usage",
  headers={
    "X-API-Key": "wq_xxxxxxxxxx_your_secret",
  },
)
print(r.json())

Снимок usage для аккаунта ключа. Квоту генераций не тратит. Объект `usage` такой же, как в ответе POST /v1/generate.

• a7k2m9 Квадрат
• b3n5p1 Квадрат с выемкой
• c8q4r6 Сквиркл
• d1s7t9 Скруглённые соединённые
• e6u2v4 Острые соединённые
• f9w5x7 Точка
• g2y8z0 Скруглённая точка
• h4a6b8 Точка (горизонталь)
• i0c2d4 Точка (вертикаль)
• j6e8f0 Ромб
• k2g4h6 Звезда
• l8i0j2 Пиксельная звезда
• m4k6l8 Сердце
• n0o2p4 Плюс
• p6q8r0 Скруглённый плюс
• q1r3s5 Скруглённый квадрат
• s1r3s5 Скруглённый квадрат

• r2s4t6 Квадрат
• u8v0w2 Скруглённый квадрат
• x4y6z8 Круг
• a1b3c5 Ромб
• d7e9f1 D-форма
• g3h5i7 D-форма инверсия
• j9k1l3 Лист
• m5n7o9 Лист с кругом
• p1q3r5 Лист с кругом (поворот)
• s7t9u1 Лист (вариант)
• v3w5x7 Квадрат с кругом
• y9z1a3 Скруглённый острый
• b5c7d9 Сквиркл
• e1f3g5 Капля

• h7i9j1 Квадрат
• k3l5m7 Сквиркл
• n9o1p3 Круг
• q5r7s9 Скошенный квадрат
• t1u3v5 D-форма
• w7x9y1 D-форма инверсия
• z3a5b7 Лист
• c9d1e3 Звезда
• f5g7h9 Ромб
• i1j3k5 X-форма
• l7m9n1 Плюс
• o3p5q7 Клевер
• r9s1t3 Скруглённый X
• u5v7w9 Сердце

• n0f1r2 Без рамки
• t7r8d9 Толстая скруглённая рамка
• l4b5t6 Метка снизу
• b3n4t5 Баннер сверху
• b7b8d9 Бэдж снизу
• b5d6t7 Бэдж сверху
• b9b0t1 Планка снизу
• b2t3p4 Планка сверху
• w4t5p6 Широкая планка сверху
• w1d2b3 Широкая планка снизу
• p0l1b2 Пилюля снизу
• p8t9p0 Пилюля сверху
• s6b7g8 Пакет

• La1b2c Facebook
• Ld3e4f Messenger
• Lg5h6i Instagram
• Lj7k8l LinkedIn
• Lm9n0o YouTube
• Ls3t4u Phone
• Lv5w6x Telegram
• Ly7z8a SMS
• Lb9c0d Email
• Le1f2g Wi‑Fi
• Lh3i4j Restaurant
• Lk5l6m Location
• Ln7o8p Gallery
• Lq9r0s Profile
• Lt1u2v WhatsApp
• Lw3x4y Link
• Lz5a6b Promo
• Lc7d8e Lock

• horizontal
• vertical
• diagonal
• inverse_diagonal
• radial

• Одна успешная генерация = +1 used_count. Ошибки валидации и 4xx/5xx не считаются.
• GET /v1/usage — для дашбордов и алертов: те же счётчики, без списания.
• Если overage подключён и статус payment_failed — весь Static QR API заблокирован (включая included quota), пока не исправлена оплата.
• Строки-подсказки (what_counts_toward_limit и др.) — для людей; автоматику стройте по числам и error.code.

Поля объекта `usage` в ответах generate и usage:

• period
• used_count
• included_limit
• paid_count
• charged_cents
• spending_cap_cents
• included_quota_resets_at
• what_counts_toward_limit
• what_does_not_count
• included_quota_note
• overage_linear_floor_hint

Биллинг API в кабинете

• Храните ключ только на сервере — не в браузере, мобильном приложении и не в публичных репозиториях.
• Вызывайте api.* с бэкенда. CORS для Static QR API в браузере не рассчитан — используйте сервер или Конструктор API в кабинете.
• Опционально ограничьте ключ IP серверов (или egress CDN). Пустой allowlist = любой IP.
• Опционально включите HMAC в кабинете. Тогда оба заголовка нужны на каждом маршруте — включая GET /v1/usage.

1714412345
POST
/v1/generate
<sha256_hex_сырого_тела>

1714412345
GET
/v1/usage
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

# Build signature on your server, then attach headers to curl
TS=$(date +%s)
BODY='{"data":"https://webqr.io"}'
BODY_HASH=$(printf %s "$BODY" | openssl dgst -sha256 -hex | awk '{print $2}')
SECRET="${API_KEY##*_}"  # 40 chars after the second underscore
CANON=$(printf '%s\nPOST\n/v1/generate\n%s' "$TS" "$BODY_HASH")
SIG=$(printf %s "$CANON" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $2}')
curl -X POST https://api.webqr.io/v1/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -H "X-WebQR-Timestamp: $TS" \
  -H "X-WebQR-Signature: $SIG" \
  -d "$BODY"

<?php
$apiKey = getenv('WEBQR_API_KEY');
$secret = substr($apiKey, strrpos($apiKey, '_') + 1);
$ts = (string) time();
$body = json_encode(['data' => 'https://webqr.io'], JSON_UNESCAPED_SLASHES);
$canonical = $ts . "\nPOST\n/v1/generate\n" . hash('sha256', $body);
$signature = hash_hmac('sha256', $canonical, $secret);

$ch = curl_init('https://api.webqr.io/v1/generate');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'X-API-Key: ' . $apiKey,
    'X-WebQR-Timestamp: ' . $ts,
    'X-WebQR-Signature: ' . $signature,
  ],
  CURLOPT_POSTFIELDS => $body,
]);
echo curl_exec($ch);

import crypto from 'node:crypto';

const apiKey = process.env.WEBQR_API_KEY;
const secret = apiKey.slice(apiKey.lastIndexOf('_') + 1);
const ts = String(Math.floor(Date.now() / 1000));
const body = JSON.stringify({ data: 'https://webqr.io' });
const bodyHash = crypto.createHash('sha256').update(body).digest('hex');
const canonical = `${ts}\nPOST\n/v1/generate\n${bodyHash}`;
const signature = crypto.createHmac('sha256', secret).update(canonical).digest('hex');

const res = await fetch('https://api.webqr.io/v1/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': apiKey,
    'X-WebQR-Timestamp': ts,
    'X-WebQR-Signature': signature,
  },
  body,
});
console.log(await res.json());

import hashlib, hmac, json, os, time, urllib.request

api_key = os.environ["WEBQR_API_KEY"]
secret = api_key.rsplit("_", 1)[-1]
ts = str(int(time.time()))
body = json.dumps({"data": "https://webqr.io"}, separators=(",", ":"))
body_hash = hashlib.sha256(body.encode()).hexdigest()
canonical = f"{ts}\nPOST\n/v1/generate\n{body_hash}"
signature = hmac.new(secret.encode(), canonical.encode(), hashlib.sha256).hexdigest()

req = urllib.request.Request("https://api.webqr.io/v1/generate", data=body.encode(), method="POST")
req.add_header("Content-Type", "application/json")
req.add_header("X-API-Key", api_key)
req.add_header("X-WebQR-Timestamp", ts)
req.add_header("X-WebQR-Signature", signature)
print(urllib.request.urlopen(req).read().decode())

curl -X POST https://api.webqr.io/v1/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: wq_xxxxxxxxxx_your_secret" \
  -H "X-WebQR-Timestamp: 1714412345" \
  -H "X-WebQR-Signature: 64_hex_chars_lowercase_hmac_sha256_placeholder_do_not_use_as_is" \
  -d '{
    "data": "https://webqr.io",
    "design": {
        "size": 512,
        "color": "#000000",
        "backgroundColor": "#FFFFFF",
        "styleType": "a7k2m9",
        "eyeType": "r2s4t6",
        "showColorGradient": false
    }
}'

<?php
$ch = curl_init('https://api.webqr.io/v1/generate');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'X-API-Key: wq_xxxxxxxxxx_your_secret',
    'X-WebQR-Timestamp: 1714412345',
    'X-WebQR-Signature: 64_hex_chars_lowercase_hmac_sha256_placeholder_do_not_use_as_is'
  ],
  CURLOPT_POSTFIELDS => '{
    "data": "https://webqr.io",
    "design": {
        "size": 512,
        "color": "#000000",
        "backgroundColor": "#FFFFFF",
        "styleType": "a7k2m9",
        "eyeType": "r2s4t6",
        "showColorGradient": false
    }
}',
]);
echo curl_exec($ch);

const res = await fetch('https://api.webqr.io/v1/generate', {
  method: 'POST',
  headers: {
      "Content-Type": "application/json",
      "X-API-Key": "wq_xxxxxxxxxx_your_secret",
      "X-WebQR-Timestamp": "1714412345",
      "X-WebQR-Signature": "64_hex_chars_lowercase_hmac_sha256_placeholder_do_not_use_as_is"
  },
  body: JSON.stringify({
    "data": "https://webqr.io",
    "design": {
        "size": 512,
        "color": "#000000",
        "backgroundColor": "#FFFFFF",
        "styleType": "a7k2m9",
        "eyeType": "r2s4t6",
        "showColorGradient": false
    }
}),
});
const data = await res.json();
console.log(data);

import requests

r = requests.post(
  "https://api.webqr.io/v1/generate",
  headers={
      "Content-Type": "application/json",
      "X-API-Key": "wq_xxxxxxxxxx_your_secret",
      "X-WebQR-Timestamp": "1714412345",
      "X-WebQR-Signature": "64_hex_chars_lowercase_hmac_sha256_placeholder_do_not_use_as_is"
  },
  json={
      "data": "https://webqr.io",
      "design": {
          "size": 512,
          "color": "#000000",
          "backgroundColor": "#FFFFFF",
          "styleType": "a7k2m9",
          "eyeType": "r2s4t6",
          "showColorGradient": false
      }
  },
)
print(r.json())