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

  1. Obsługa Błędów Limitów Czasowych: Wprowadź odpowiednią obsługę błędów dla operacji z limitami czasowymi
  2. Exponential Backoff: Użyj wykładniczego opóźnienia przy ponownym próbie żądań z limitami czasowymi
  3. 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.

Asystent AI

Odpowiedzi są generowane przy użyciu sztucznej inteligencji i mogą zawierać błędy.

Jak mogę Ci pomóc?

Zapytaj mnie o cokolwiek dotyczącego Blue lub tej dokumentacji.

Wciśnij Enter, aby wysłać • Shift+Enter, aby dodać nową linię • ⌘I, aby otworzyć