Wytyczne dotyczące limitów czasowych API Blue
W ogólności, API Blue nie narzuca sztywnych limitów czasowych na większość operacji. Jednakże, niektóre wrażliwe operacje mają określone limity czasowe, aby zapobiec nadużyciom i zapewnić stabilność systemu.
Operacje z Limitami Czasowymi
Następujące operacje mają narzucone limity czasowe:
Operacja | Limit Czasowy | Okno | Cel |
---|---|---|---|
signIn |
5 requests | 60 seconds | Zapobieganie atakom brute force |
signInRequest |
3 requests | 120 seconds | Ograniczenie prób uwierzytelnienia |
createDocument |
5 requests | 60 seconds | Zapobieganie spamowi dokumentów |
sendTestEmail |
5 requests | 60 seconds | Zapobieganie nadużyciom e-mailowym |
submitForm |
5 requests | 60 seconds | Zapobieganie spamowi formularzy |
exportTodos |
1 request | 50 seconds | Ograniczenie zasobochłonnych eksportów |
deleteCompany |
3 requests | 60 seconds | Zapobieganie przypadkowemu usunięciu |
deleteCompanyRequest |
3 requests | 60 seconds | Zapobieganie przypadkowemu usunięciu |
updateEmail |
3 requests | 60 seconds | Zapobieganie nadużyciom zmiany e-maila |
updateEmailRequest |
3 requests | 60 seconds | Zapobieganie nadużyciom zmiany e-maila |
verifyAcceptInvitation |
3 requests | 60 seconds | Ograniczenie prób weryfikacji |
verifySecurityCode |
3 requests | 60 seconds | Ograniczenie prób weryfikacji |
Zachowanie Limitów Czasowych
- Na Użytkownika: Limity czasowe są stosowane na użytkownika uwierzytelnionego
- Na IP: W przypadku nieautoryzowanych żądań, limity są stosowane na adres IP
- Brak Nagród: Informacje o limitach czasowych nie są zawarte w nagłówkach odpowiedzi
Odpowiedź Błędów
Gdy limit czasowy zostanie przekroczony, otrzymasz błąd GraphQL:
{
"errors": [{
"message": "Rate limit exceeded",
"extensions": {
"code": "RATE_LIMITED"
}
}]
}
Najlepsze Praktyki
- Obsługa Błędów Limitów Czasowych: Wprowadź odpowiednią obsługę błędów dla operacji z limitami czasowymi
- Exponential Backoff: Użyj wykładniczego opóźnienia przy ponownym próbie żądań z limitami czasowymi
- Monitorowanie Użycia: Bądź świadomy, które operacje mają limity podczas budowania integracji
W przypadku pytań dotyczących limitów czasowych, prosimy o kontakt z naszym zespołem wsparcia.