# 🚫 API Rate Limit 적용 안정적인 서비스 이용을 위해 Rate Limit 정책이 단계적으로 시행됩니다. **유예 기간** (2025년 3월 1일 시작): 해당 기간은 변경될 정책에 적응하고 API 사용량을 조절할 수 있도록 마련되었습니다. > 확정된 Rate Limit 규칙이 공지되며, 응답 헤더를 통해 예상 결과를 미리 확인하실 수 있습니다. 실제 요청 차단은 유예 기간 동안 적용되지 않습니다. **활성** (2025년 9월 1일 시작): Rate Limit 규칙이 완전히 적용되어, 제한 초과 요청은 HTTP 429 오류와 함께 거부됩니다. > 📘 > > 현재는 **유예 기간** 입니다.
## API Rate Limit 규칙 API 요청에 대한 응답에는 현재 Rate Limit 상태를 나타내는 헤더 정보가 포함됩니다. 이를 통해 현재 사용 가능한 요청 횟수와 제한 관련 정보를 확인할 수 있습니다.

응답 헤더	설명	예시 값
X-RateLimit-Limit	해당 엔드포인트의 최대 허용 요청 수	600
X-RateLimit-Remaining	현재 남은 요청 가능 횟수	400
X-RateLimit-Reset	Rate Limit이 초기화되는 시간(Unix 타임스탬프)	1620235582
X-Retry-After	요청을 다시 시도하기 전에 기다려야 하는 시간(초) 형식\ (요청 제한 초과 시 제공)	35

***
대부분의 API는 **분당 600회**의 요청 제한이 적용되지만, 다음 API 목록은 **분당 300회**의 요청 제한이 적용됩니다. 제한 횟수를 초과하면 [HTTP 429 (Too Many Requests) 오류](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429)가 발생하니 유의하시기 바랍니다. > ❗️ > > 요청 제한 초과 시 HTTP 429(Too Many Requests) 상태 코드와 함께 X-Retry-After 헤더가 반환됩니다.\ > \[[API Rate Limit 정책 안내](https://developers.modusign.co.kr/docs/api-rate-limit-%EC%A0%95%EC%B1%85-%EC%95%88%EB%82%B4)] 를 참고하여 요청 제어 및 Retry 정책 등을 준비해주세요. | API | Method | Endpoint | | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----- | :------------------------------------ | | [문서 리스트 조회](https://developers.modusign.co.kr/reference/documentcontroller_getdocuments) | GET | /documents | | [서명 요청](https://developers.modusign.co.kr/reference/documentcontroller_create) | POST | /documents | | [템플릿으로 서명 요청](https://developers.modusign.co.kr/reference/documentcontroller_createdocumentwithtemplate) | POST | /documents/request-with-template | | [템플릿으로 임베디드 초안 생성](https://developers.modusign.co.kr/docs/%EC%9E%84%EB%B2%A0%EB%94%94%EB%93%9C-%EC%84%9C%EB%AA%85-%EC%9A%94%EC%B2%AD#%ED%85%9C%ED%94%8C%EB%A6%BF%EC%9C%BC%EB%A1%9C-%EC%B4%88%EC%95%88-%EB%A7%8C%EB%93%A4%EA%B8%B0) | POST | /embedded-drafts/create-with-template | | [템플릿 생성](https://developers.modusign.co.kr/reference/templatecontroller_create) | POST | /templates | | [파일 업로드](https://developers.modusign.co.kr/reference/filecontroller_uploadfile) | POST | /files | ***