🚫 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) 오류가 발생하니 유의하시기 바랍니다.

❗️
요청 제한 초과 시 HTTP 429(Too Many Requests) 상태 코드와 함께 X-Retry-After 헤더가 반환됩니다.
[API Rate Limit 정책 안내] 를 참고하여 요청 제어 및 Retry 정책 등을 준비해주세요.

API	Method	Endpoint
문서 리스트 조회	GET	/documents
서명 요청	POST	/documents
템플릿으로 서명 요청	POST	/documents/request-with-template
템플릿으로 임베디드 초안 생성	POST	/embedded-drafts/create-with-template
템플릿 생성	POST	/templates
파일 업로드	POST	/files