Rate limits i kvote
Da bismo osigurali stabilnu dostupnost API-ja svim korisnicima, primjenjujemo rate limite po tokenu.
Ograničenja
| Endpoint kategorija | Zahtjeva u sekundi | Zahtjeva na sat |
|---|---|---|
| Read (GET /modules, /invoices) | 10 | 1.000 |
| Reports (GET /reports/*) | 2 | 200 |
| Write (POST/PUT/DELETE) | 5 | 500 |
Zaglavlja odgovora
Svaki odgovor sadrži zaglavlja:
X-RateLimit-Limit— vaše trenutno ograničenje na sat za tu kategorijuX-RateLimit-Remaining— koliko zahtjeva vam još preostaje u trenutnom prozoruX-RateLimit-Reset— Unix timestamp kada se prozor resetira
429 Too Many Requests
Ako prijeđete limit, primit ćete status 429 s zaglavljem Retry-After koje označava broj sekundi do sljedeće mogućnosti. Preporučuje se implementacija exponential backoff-a: 1s, 2s, 4s, 8s, 16s.
Zahtjev za povećanje limita
Ako vaš use case zahtijeva veće limite, obratite se na podrska@phobspms.com s opisom scenarija. Za velike multi-property grupe odobravamo povećanje na 30 rps read / 15 rps write bez dodatne naplate.