Hesap

Hesap

API hesabının detaylarını al — bakiye, overage ayarları ve ürün bazlı abonelik bilgileri ile kullanım sayaçları.

Endpoint

Bu endpoint, kimliği doğrulanmış API key için hesap detaylarını döndürür: kalan bakiye, overage yapılandırması ve ürün bazlı abonelik durumu, döneme kadar olan kullanım bilgileriyle birlikte.

GET   /v2/account

Kimlik doğrulama

API key'ini x-api-key request header'ı olarak ekle.

x-api-key: YourSecretAPIKey

Yanıt alanları

AlanTipAçıklama
balancenumberHesaptaki kalan ön ödemeli bakiye, kredi cinsinden.
overageEnabledbooleanBu hesap için overage faturalamanın etkin olup olmadığı.
overageSpendingLimitnumberHesabın bu dönemde biriktirebileceği maksimum overage, kredi cinsinden. 0 limit ayarlanmadığı anlamına gelir.
subscriptionsobjectÜrün anahtarından abonelik nesnesine map. Alanlar için aşağıya bak.

Her abonelik için alanlar (subscriptions içindeki her değer):

AlanTipAçıklama
planIdstringPlan kimliği (örneğin steam-full, endpoint-2.5m, thirdparty-none).
startDatestring (ISO 8601)Mevcut planın ne zaman başladığı.
endDatestring (ISO 8601)Mevcut plan döneminin ne zaman sona ereceği.
statusstringAbonelik durumu (örneğin active).
autoRenewbooleanAboneliğin nextRenewalDate'te otomatik yenilenip yenilenmediği.
pendingPlanIdstring | nullAboneliğin bir sonraki döngüde geçeceği plan, varsa.
pendingChangeTypestring | nullBekleyen değişikliğin tipi (upgrade, downgrade) ya da null.
cycleStartDatestring (ISO 8601)Mevcut faturalama döngüsünün başlangıcı.
nextRenewalDatestring (ISO 8601)Bir sonraki planlanmış yenileme tarihi.
usageobjectEndpoint yolu ya da kullanım kategorisinden bu döngüde tüketilen request sayısına map.
billedOveragenumberBu döngüde zaten faturalanmış overage tutarı, kredi cinsinden.

Abonelik ürünleri ve planları

subscriptions nesnesi ürün kategorisine göre anahtarlanır. Her ürünün kendi plan setleri vardır; planId değerleri yalnızca kendi ürün kategorisi içinde geçerlidir.

STEAM_DATA

Temel Steam veri kotası (profiller, envanterler, apps, items).

Plan IDFiyatAralık
steam-noneÜcretsizay
steam-30days€4.99ay
steam-180days€19.99ay
steam-full€29.99ay

EXTRA_REQUESTS

Temel planın üzerine ek request kotası. Aylık fiyatlama, request başına overage ile birlikte.

Plan IDMaksimum requestFiyatAralık
endpoint-none500Ücretsizrequest başına
endpoint-100k100.000€9.99ay
endpoint-250k250.000€24.99ay
endpoint-500k500.000€44.99ay
endpoint-1m1.000.000€89.99ay
endpoint-2.5m2.500.000€189.99ay
endpoint-10m10.000.000€599.99ay
endpoint-40m40.000.000€1.799,99ay

THIRD_PARTY_MARKET_DATA

Üçüncü taraf marketplace veri erişimi.

Plan IDFiyatAralık
thirdparty-noneÜcretsizay
thirdparty-data€49.99ay
thirdparty-data-history-15€54.99ay
thirdparty-data-history-30€69.99ay
thirdparty-data-history-180€99.99ay

THIRD_PARTY_ADDON_SALES

Üçüncü taraf satış verisi eklentisi.

Plan IDFiyatAralık
addons-sales€49.99ay

THIRD_PARTY_ADDON_WSS

Üçüncü taraf WebSocket stream eklentisi.

Plan IDFiyatAralık
addons-wss€39.99ay

Plan ID'leri ve fiyatlar zamanla değişebilir. planId'yi ürün kategorisinin kapsamındaki opak bir tanımlayıcı olarak değerlendir.

Yanıt örneği

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
      }
    }
  }
}