Аккаунт

Аккаунт

Получи детали своего API-аккаунта — баланс, настройки overage и информацию о подписках на продукты со счётчиками использования.

Эндпоинт

Этот эндпоинт возвращает детали аккаунта для аутентифицированного API-ключа — остаток баланса, конфигурацию overage и статус подписок по продуктам с использованием в текущем расчётном цикле.

GET   /v2/account

Аутентификация

Передай свой API-ключ через request header x-api-key.

x-api-key: YourSecretAPIKey

Поля ответа

ПолеТипОписание
balancenumberОстаток предоплаченного баланса на аккаунте, в кредитах.
overageEnabledbooleanВключено ли overage-выставление счетов для этого аккаунта.
overageSpendingLimitnumberМаксимальная сумма overage, которую аккаунт может накопить в этом цикле, в кредитах. 0 означает, что лимит не установлен.
subscriptionsobjectMap ключа продукта в объект подписки. Поля см. ниже.

Поля каждой подписки (каждое значение внутри subscriptions):

ПолеТипОписание
planIdstringИдентификатор плана (например, steam-full, endpoint-2.5m, thirdparty-none).
startDatestring (ISO 8601)Когда начался текущий план.
endDatestring (ISO 8601)Когда заканчивается срок текущего плана.
statusstringСтатус подписки (например, active).
autoRenewbooleanПродлевается ли подписка автоматически в nextRenewalDate.
pendingPlanIdstring | nullПлан, на который подписка переключится в следующем цикле, если запланировано.
pendingChangeTypestring | nullТип ожидаемого изменения (upgrade, downgrade) или null.
cycleStartDatestring (ISO 8601)Начало текущего расчётного цикла.
nextRenewalDatestring (ISO 8601)Следующая запланированная дата продления.
usageobjectMap пути endpoint'а или категории использования в количество запросов, потраченных в этом цикле.
billedOveragenumberСумма overage, уже списанная в этом цикле, в кредитах.

Продукты подписки и планы

Объект subscriptions индексируется по категории продукта. У каждого продукта свой набор планов; значения planId применимы только в пределах своей категории продукта.

STEAM_DATA

Базовая квота данных Steam (профили, инвентари, apps, items).

Plan IDЦенаИнтервал
steam-noneБесплатноmonth
steam-30days€4.99month
steam-180days€19.99month
steam-full€29.99month

EXTRA_REQUESTS

Дополнительная квота запросов поверх базового плана. Ежемесячная цена с overage, начисляемым за запрос.

Plan IDМаксимум запросовЦенаИнтервал
endpoint-none500Бесплатноза запрос
endpoint-100k100 000€9.99month
endpoint-250k250 000€24.99month
endpoint-500k500 000€44.99month
endpoint-1m1 000 000€89.99month
endpoint-2.5m2 500 000€189.99month
endpoint-10m10 000 000€599.99month
endpoint-40m40 000 000€1 799,99month

THIRD_PARTY_MARKET_DATA

Доступ к данным сторонних маркетплейсов.

Plan IDЦенаИнтервал
thirdparty-noneБесплатноmonth
thirdparty-data€49.99month
thirdparty-data-history-15€54.99month
thirdparty-data-history-30€69.99month
thirdparty-data-history-180€99.99month

THIRD_PARTY_ADDON_SALES

Аддон данных о продажах сторонних источников.

Plan IDЦенаИнтервал
addons-sales€49.99month

THIRD_PARTY_ADDON_WSS

Аддон WebSocket-стрима сторонних источников.

Plan IDЦенаИнтервал
addons-wss€39.99month

Plan ID и цены могут меняться со временем. Рассматривай planId как непрозрачный идентификатор в рамках своей категории продукта.

Пример ответа

response.json
{
  "success": true,
  "result": {
    "balance": 493177.0881900459,
    "overageEnabled": true,
    "overageSpendingLimit": 0,
    "subscriptions": {
      "STEAM_DATA": {
        "planId": "steam-full",
        "startDate": "2026-01-19T03:35:35.815Z",
        "endDate": "2026-05-19T03:35:35.815Z",
        "status": "active",
        "autoRenew": true,
        "pendingPlanId": null,
        "pendingChangeType": null,
        "cycleStartDate": "2026-01-19T03:35:35.815Z",
        "nextRenewalDate": "2026-05-19T03:35:35.815Z",
        "usage": {
          "steam/inventory": 122935,
          "steam/profile": 83223,
          "market/items": 276,
          "market/item": 20928,
          "/v2/steam/users/:steamid": 5,
          "/v2/steam/apps/:appId": 5
        },
        "billedOverage": 0
      },
      "EXTRA_REQUESTS": {
        "planId": "endpoint-2.5m",
        "startDate": "2026-01-19T03:35:36.067Z",
        "endDate": "2026-05-19T03:35:35.815Z",
        "status": "active",
        "autoRenew": true,
        "pendingPlanId": null,
        "pendingChangeType": null,
        "cycleStartDate": "2026-01-19T03:35:35.815Z",
        "nextRenewalDate": "2026-05-19T03:35:35.815Z",
        "usage": {
          "steam/profile": 83223,
          "steam/inventory": 122476,
          "market/item": 20928,
          "/v2/steam/apps": 1,
          "/v2/steam/users/:steamid/friends": 1
        },
        "billedOverage": 0
      },
      "THIRD_PARTY_MARKET_DATA": {
        "planId": "thirdparty-none",
        "startDate": "2026-01-19T03:38:43.170Z",
        "endDate": "2026-05-19T03:35:35.815Z",
        "status": "active",
        "autoRenew": true,
        "pendingPlanId": null,
        "pendingChangeType": null,
        "cycleStartDate": "2026-01-19T03:35:35.815Z",
        "nextRenewalDate": "2026-05-19T03:35:35.815Z",
        "usage": {
          "market/items": 276,
          "market/item": 20928
        },
        "billedOverage": 0
      }
    }
  }
}