Skip to Content
Plany i limity

Plany i limity

Ta strona porównuje dostępne plany i limity API LokalScore. Tabele poniżej są pobierane na żywo z bazy danych przez publiczny endpoint GET /api/v1/pricing — jeśli zmienisz plan lub limit w Portalu, dokumentacja zaktualizuje się automatycznie, bez publikowania nowej wersji.

Ładowanie aktualnych planów…

Jak działają limity

Limity są egzekwowane przez backend przy każdym żądaniu w zależności od klucza API. W verify_api_key sprawdzane są trzy poziomy:

1. Limit na sekundę (rate limiting)

Każdy klucz ma limit zapytań na sekundę (sliding window, realizowany na zbiorze Redis ZSET). Po przekroczeniu limitu otrzymasz odpowiedź 429:

{ "detail": "Przekroczono limit zapytań (Dopuszczalny limit: 10 req/sec)" }
  • Okno czasowe to 1 sekunda — zapytania są liczone w oknie kroczącym.
  • Limitu nie można obejść przez równoległe wysyłanie zapytań — licznik jest współdzielony między żądaniami tego samego klucza.

2. Limit miesięczny

Każdy plan ma miesięczny limit zapytań (licznik monthly_calls resetowany co miesiąc w Redis). Po jego wyczerpaniu:

  • Jeśli plan ma zdefiniowane overage (extra_request_price > 0), zapytania są nadal obsługiwane, a każde ponad limit jest rozliczane indywidualnie i zapisywane w tabeli portal.overage_items.
  • W przeciwnym razie otrzymasz odpowiedź 429:
{ "detail": "Przekroczono miesięczny limit zapytań API (Maksymalnie: 50000/miesięcznie)" }

3. Dodatkowe limity warstwy serwera

Niezależnie od klucza API nginx egzekwuje per-IP limit 30 req/s dla całego /api/ (burst 10) — patrz nginx.conf. Ten limit chroni backend przed nadużyciami i działa równolegle z limitami klucza.

Overage (dopłaty za nadwyżkę)

Overage oznacza, że po przekroczeniu limitu miesięcznego zapytania nie są blokowane, ale każda jednostka ponad limit jest rozliczana po cenie jednostkowej (extra_request_price). To przydatne, gdy masz sporadyczne skoki ruchu i nie chcesz przerywać działania integracji.

  • Cena jednostkowa jest definiowana per plan w bazie i może się zmieniać — sprawdź aktualną wartość w tabelach powyżej lub w Portalu.
  • Wszystkie pozycje overage są rejestrowane w portal.overage_items i widoczne w sekcji Metryki zużycia w Portalu klienta.
  • Jeśli nie chcesz ponosić kosztów overage, rozważ plan z wyższym limitem lub monitorowanie zużycia (patrz Autentykacja → Limity).

Sprawdzanie zużycia

Bieżące zużycie (miesięczne, dzienne, opóźnienia) możesz sprawdzić w Portalu klienta w sekcji Metryki zużycia.

Zalecenia

  • Wybierz plan z zapasem względem przewidywanego szczytowego ruchu.
  • Monitoruj zużycie, aby uniknąć niespodziewanych kosztów overage.
  • Dla błędów 429 wdróż retry z wykładniczym backoffem i jitterem.
LokalScore
System scoringu lokalizacji i wyceny nieruchomości w Polsce.
© 2026 LokalScore. Wszelkie prawa zastrzeżone.