Ten przewodnik wyjaśnia jak działa system kredytów i jak doładować wallet żeby zacząć wykonywać wywołania API.
Jak działają kredyty
Każda operacja API pobiera stałą liczbę kredytów z salda Twojego walleta. Kredyty nie wygasają — możesz ich używać kiedy chcesz, bez presji czasowej. Saldo jest wspólne dla wszystkich Twoich tokenów API.
Jak doładować
Wywołaj endpoint topup z wybranym slugiem pakietu. Odpowiedź zawiera checkout_url — otwórz go w przeglądarce żeby sfinalizować płatność przez Paddle. Kredyty są dodawane automatycznie po potwierdzeniu płatności.
POST /api/v1/wallet/topup curl -X POST https://alexambros.com/api/v1/wallet/topup \ -H "Authorization: Bearer sk_api_xxxx" \ -H "Content-Type: application/json" \ -d '{ "package_slug": "pack_1000" }'
{
"status": "success",
"data": {
"checkout_url": "https://alexambros.com/checkout-pay?_ptxn=txn_01...",
"package": "pack_1000",
"credits": 1000
}
}
Po płatności sprawdź nowe saldo wywołując GET /api/v1/wallet.
Sprawdź saldo
W każdej chwili możesz sprawdzić aktualne saldo i łączną liczbę zakupionych kredytów.
GET /api/v1/wallet curl https://alexambros.com/api/v1/wallet \ -H "Authorization: Bearer sk_api_xxxx"
{
"status": "success",
"data": {
"balance": 99845,
"total_purchased": 100000
}
}
Historia transakcji
Każde pobranie kredytów i doładowanie jest rejestrowane. Użyj endpointu transakcji żeby audytować swoje użycie — każdy wpis pokazuje operację, kwotę i saldo po transakcji.
GET /api/v1/wallet/transactions curl "https://alexambros.com/api/v1/wallet/transactions?page=1" \ -H "Authorization: Bearer sk_api_xxxx"
{
"status": "success",
"data": [
{
"type": "withdrawal",
"amount": "20.00",
"balance_after": "99038.00",
"description": "Wywołanie API: api.v1.companies.search",
"created_at": "2026-03-21T11:47:08.000000Z"
},
{
"type": "deposit",
"amount": "100000.00",
"balance_after": "100000.00",
"description": "Wallet top-up: pack_1000",
"created_at": "2026-03-17T09:00:00.000000Z"
}
]
}
Wskazówka
Przeglądanie watchlisty (GET /companies/watched) jest całkowicie bezpłatne — kredyty nie są pobierane. Używaj tego endpointu żeby sprawdzać obserwowane firmy bez obawy o saldo.