Каталог

1
import urllib.error
2
import urllib.request
3
4
GLOBAL_URL = "https://downloads.voodoo.center/catalog.lmdb.zst"
5
PERSONAL_URL = "https://downloads.voodoo.center/{client_id}.lmdb.zst"
6
7
8
def download_catalog(client_id: str, dest: str = "catalog.lmdb.zst") -> str:
9
    # Надаємо перевагу персональному каталогу (ваші узгоджені ціни); повертаємось
10
    # до глобального, якщо цей акаунт не має персонального файлу (404 на персональній URL).
11
    try:
12
        urllib.request.urlretrieve(PERSONAL_URL.format(client_id=client_id), dest)
13
    except urllib.error.HTTPError as exc:
14
        if exc.code != 404:
15
            raise
16
        urllib.request.urlretrieve(GLOBAL_URL, dest)
17
    return dest
18
19
20
# Візьміть свій client id зі сторінки API в дашборді.
21
download_catalog("your-client-id")   # -> catalog.lmdb.zst
22
# Тепер розпакуйте, відкрийте та прочитайте його точно так, як показано нижче.

$
pip install zstandard lmdb

$
# Завантажте стиснений знімок
$
curl -o catalog.lmdb.zst https://downloads.voodoo.center/catalog.lmdb.zst
$
$
# Розпакуйте zstd-фрейм у однофайлову базу даних LMDB
$
zstd -d catalog.lmdb.zst -o catalog.lmdb    # або: unzstd catalog.lmdb.zst

1
import json
2
import struct
3
import urllib.request
4
5
import lmdb
6
import zstandard
7
8
CATALOG_URL = "https://downloads.voodoo.center/catalog.lmdb.zst"
9
10
11
def item_key(item_id: int) -> bytes:
12
    # Записи індексуються 8-байтним item id у форматі big-endian (тож сортуються за id).
13
    return struct.pack(">Q", item_id)
14
15
16
# 1. Завантажте стиснений знімок.
17
urllib.request.urlretrieve(CATALOG_URL, "catalog.lmdb.zst")
18
19
# 2. Потоково розпакуйте zstd-фрейм у однофайлову базу даних LMDB.
20
dctx = zstandard.ZstdDecompressor()
21
with open("catalog.lmdb.zst", "rb") as fin, open("catalog.lmdb", "wb") as fout:
22
    dctx.copy_stream(fin, fout)
23
24
# 3. Відкрийте середовище лише для читання. Це один ФАЙЛ, а не каталог (subdir=False),
25
#    і читачі в режимі лише для читання мають передавати lock=False.
26
env = lmdb.open("catalog.lmdb", subdir=False, readonly=True, lock=False)
27
28
# Знайдіть один товар за id.
29
with env.begin() as txn:
30
    raw = txn.get(item_key(4211))
31
    item = json.loads(raw) if raw else None
32
    print(item)
33
34
# Ітеруйте весь каталог (записи виходять упорядкованими за id).
35
with env.begin() as txn:
36
    for key, value in txn.cursor():
37
        item = json.loads(value)
38
        if item["in_stock"]:
39
            price = item["price"] / 100  # центи -> основні одиниці
40
            print(item["id"], item["product_type"], f"{price:.2f}", item["name"])

1
{
2
  "id": 4211,
3
  "name": "Sample Game Top-up",
4
  "product_type": "topup",
5
  "min_quantity": 1,
6
  "max_quantity": 1000,
7
  "price": 1250,
8
  "base_price": 1250,
9
  "subscriber_price": 1150,
10
  "amount_per_price": 1,
11
  "in_stock": true,
12
  "updated_at": "2026-07-05T12:00:00+00:00",
13
  "fields": [
14
    { "id": 88, "name": "player_id", "type": "string", "required": true, "options": [] },
15
    {
16
      "id": 91, "name": "server", "type": "choice", "required": true,
17
      "options": [
18
        { "id": 17, "value": "Europe (EU-West)" },
19
        { "id": 18, "value": "North America" }
20
      ]
21
    }
22
  ]
23
}

1
# `item` — це запис, прочитаний з каталогу вище; `access_token` — ваш
2
# Bearer-токен (див. Автентифікація).
3
import urllib.request, json
4
5
body = {
6
    "item_id": item["id"],
7
    "quantity": 10,                 # у межах min_quantity..max_quantity
8
    "merchant_order_id": "po-10232",
9
    "fields": {
10
        "player_id": "123456789",   # текстове поле -> його рядкове значення
11
        "server": 17,               # поле вибору -> id варіанта
12
    },
13
}
14
req = urllib.request.Request(
15
    "https://api.voodoo.center/api/v1/orders",
16
    data=json.dumps(body).encode(),
17
    headers={"Authorization": f"Bearer {access_token}", "Content-Type": "application/json"},
18
    method="POST",
19
)
20
order = json.loads(urllib.request.urlopen(req).read())
21
print(order["id"], order["status"])

$
# -z змушує curl надсилати If-Modified-Since на основі mtime локального файлу;
$
# 304 залишає ваш файл без змін.
$
curl -o catalog.lmdb.zst -z catalog.lmdb.zst https://downloads.voodoo.center/catalog.lmdb.zst