Konto
Konto
Pobierz szczegóły swojego konta API, w tym saldo, ustawienia overage oraz informacje o subskrypcjach produktów z licznikami użycia.
Endpoint
Ten endpoint zwraca szczegóły konta dla uwierzytelnionego API key, w tym pozostałe saldo, konfigurację overage oraz status subskrypcji poszczególnych produktów wraz z użyciem w bieżącym cyklu rozliczeniowym.
GET /v2/account
Uwierzytelnianie
Dodaj swój API key jako header x-api-key.
x-api-key: YourSecretAPIKey
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
balance | number | Pozostałe przedpłacone saldo konta, w kredytach. |
overageEnabled | boolean | Czy rozliczanie overage jest włączone dla tego konta. |
overageSpendingLimit | number | Maksymalna kwota overage, jaką konto może naliczyć w tym cyklu, w kredytach. 0 oznacza brak ustawionego limitu. |
subscriptions | object | Mapa klucza produktu na obiekt subskrypcji. Patrz pola poniżej. |
Pola pojedynczej subskrypcji (każda wartość pod subscriptions):
| Pole | Typ | Opis |
|---|---|---|
planId | string | Identyfikator planu (na przykład steam-full, endpoint-2.5m, thirdparty-none). |
startDate | string (ISO 8601) | Kiedy rozpoczął się bieżący plan. |
endDate | string (ISO 8601) | Kiedy kończy się okres bieżącego planu. |
status | string | Status subskrypcji (na przykład active). |
autoRenew | boolean | Czy subskrypcja odnawia się automatycznie w nextRenewalDate. |
pendingPlanId | string | null | Plan, na który subskrypcja przełączy się w następnym cyklu, jeśli jest zaplanowany. |
pendingChangeType | string | null | Typ oczekującej zmiany (upgrade, downgrade) lub null. |
cycleStartDate | string (ISO 8601) | Początek bieżącego cyklu rozliczeniowego. |
nextRenewalDate | string (ISO 8601) | Następna zaplanowana data odnowienia. |
usage | object | Mapa ścieżki endpointu lub kategorii użycia na liczbę requestów zużytych w tym cyklu. |
billedOverage | number | Kwota overage już rozliczona w tym cyklu, w kredytach. |
Produkty i plany subskrypcji
Obiekt subscriptions jest kluczowany po kategorii produktu. Każdy produkt ma własny zestaw planów; wartości planId są ograniczone do swojej kategorii produktu.
STEAM_DATA
Podstawowa pula danych Steam (profile, inventory, apps, items).
| Plan ID | Cena | Interwał |
|---|---|---|
steam-none | Darmowy | month |
steam-30days | €4.99 | month |
steam-180days | €19.99 | month |
steam-full | €29.99 | month |
EXTRA_REQUESTS
Dodatkowa pula requestów ponad plan bazowy. Cena miesięczna z overage naliczanym za request.
| Plan ID | Maksymalnie requestów | Cena | Interwał |
|---|---|---|---|
endpoint-none | 500 | Darmowy | za request |
endpoint-100k | 100 000 | €9.99 | month |
endpoint-250k | 250 000 | €24.99 | month |
endpoint-500k | 500 000 | €44.99 | month |
endpoint-1m | 1 000 000 | €89.99 | month |
endpoint-2.5m | 2 500 000 | €189.99 | month |
endpoint-10m | 10 000 000 | €599.99 | month |
endpoint-40m | 40 000 000 | €1 799.99 | month |
THIRD_PARTY_MARKET_DATA
Dostęp do danych marketplace'ów zewnętrznych.
| Plan ID | Cena | Interwał |
|---|---|---|
thirdparty-none | Darmowy | month |
thirdparty-data | €49.99 | month |
thirdparty-data-history-15 | €54.99 | month |
thirdparty-data-history-30 | €69.99 | month |
thirdparty-data-history-180 | €99.99 | month |
THIRD_PARTY_ADDON_SALES
Dodatek do danych sprzedażowych z zewnętrznych źródeł.
| Plan ID | Cena | Interwał |
|---|---|---|
addons-sales | €49.99 | month |
THIRD_PARTY_ADDON_WSS
Dodatek do WebSocket stream z zewnętrznych źródeł.
| Plan ID | Cena | Interwał |
|---|---|---|
addons-wss | €39.99 | month |
Plan IDs i ceny mogą zmieniać się z czasem. Traktuj planId jako nieprzezroczysty identyfikator w kontekście swojej kategorii produktu.
Przykład odpowiedzi
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
}
}
}
}