Каталог

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