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 tabeliportal.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_itemsi 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
429wdróż retry z wykładniczym backoffem i jitterem.