---

일반적으로 Blue API는 대부분의 작업에 대해 엄격한 비율 제한을 적용하지 않습니다. 그러나 특정 민감한 작업에는 남용을 방지하고 시스템 안정성을 보장하기 위해 특정 비율 제한이 있습니다.

비율 제한 작업

다음 작업에는 적용된 비율 제한이 있습니다:

작업	비율 제한	시간 창	목적
signIn	5 requests	60 seconds	무차별 공격 방지
signInRequest	3 requests	120 seconds	인증 시도 제한
createDocument	5 requests	60 seconds	문서 스팸 방지
sendTestEmail	5 requests	60 seconds	이메일 남용 방지
submitForm	5 requests	60 seconds	양식 스팸 방지
exportTodos	1 request	50 seconds	리소스 집약적인 내보내기 제한
deleteCompany	3 requests	60 seconds	우발적인 삭제 방지
deleteCompanyRequest	3 requests	60 seconds	우발적인 삭제 방지
updateEmail	3 requests	60 seconds	이메일 변경 남용 방지
updateEmailRequest	3 requests	60 seconds	이메일 변경 남용 방지
verifyAcceptInvitation	3 requests	60 seconds	인증 시도 제한
verifySecurityCode	3 requests	60 seconds	인증 시도 제한

비율 제한 동작

• 사용자당: 비율 제한은 인증된 사용자당 적용됩니다.
• IP당: 인증되지 않은 요청의 경우, 제한은 IP 주소당 적용됩니다.
• 헤더 없음: 비율 제한 정보는 응답 헤더에 포함되지 않습니다.

오류 응답

비율 제한을 초과하면 GraphQL 오류가 발생합니다:

{
  "errors": [{
    "message": "Rate limit exceeded",
    "extensions": {
      "code": "RATE_LIMITED"
    }
  }]
}

모범 사례

1. 비율 제한 오류 처리: 비율 제한 작업에 대한 적절한 오류 처리를 구현합니다.
2. 지수 백오프: 비율 제한 요청을 재시도할 때 지수 백오프를 사용합니다.
3. 사용량 모니터링: 통합을 구축할 때 어떤 작업에 제한이 있는지 인식합니다.

비율 제한에 대한 질문은 지원 팀에 문의해 주세요.