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 snapshot-ს. გენერაციის კვოტას არ ხარჯავს. `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 დაბლოკილია ჩართული კვოტითურთ.
• ტექსტური hints ადამიანებისთვისაა; ავტომატიზაცია — რიცხვებით და 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.* გამოიძახეთ ბექენდიდან. Static QR API-სთვის ბრაუზერის CORS არ არის განკუთვნილი — გამოიყენეთ სერვერი ან API კონსტრუქტორი კაბინეტში.
• ოფციონალურად შეზღუდეთ გასაღები სერვერის IP-ებით. ცარიელი 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())