API 및 개발자
크레딧 및 속도 제한
PDFSimple API는 크레딧 기반 결제 시스템을 사용합니다. 크레딧이 어떻게 소비되는지, 다 떨어지면 어떻게 되는지, API 속도 제한에 대해 알아보세요.
API 결제는 웹 요금제 작업 할당량과는 별개입니다. API 요금제를 구독하면 갱신일에 초기화되는 월간 크레딧 할당량을 받습니다.
크레딧 작동 방식
- 각 API 요청은 작업 종류와 처리된 페이지 수에 따라 일정량의 크레딧을 소비합니다.
- 크레딧은 갱신일마다 요금제의 월간 할당량으로 초기화됩니다.
- 사용하지 않은 크레딧은 다음 달로 이월되지 않습니다.
크레딧이 소진되면 어떻게 되나요
계정에 남은 크레딧이 없으면 API는 HTTP 402 Payment Required를 반환합니다. 요청은 다음 갱신일에 크레딧이 초기화되면 재개되거나, API 요금제를 업그레이드하면 즉시 재개됩니다.
http
HTTP/1.1 402 Payment Required
{
"code": 402,
"message": "Insufficient credits. Please upgrade your plan."
}속도 제한
공정한 사용을 보장하기 위해 API는 API 키별로 속도 제한을 적용합니다. 속도 제한을 초과하면 API는 HTTP 429 Too Many Requests를 반환합니다. 응답에는 재개 가능 시점을 나타내는 Retry-After 헤더가 포함됩니다.
대용량 사용 사례의 경우 지원팀에 문의하여 맞춤 한도를 논의하세요.
도움이 되었나요?