Page History
카페24 공지사항
안녕하세요! 카페24 플랫폼 기술지원팀입니다. 
2025년 10월부터 순차적으로 적용해 온 API 쿼터 제한 정책(Quota Limit) 이 2026년 4월 1일부터 모든 파트너사에 전면 적용됩니다.
유예 기간 없이 적용되오니, 아래 내용을 반드시 확인하시고 사전에 점검 및 대응해 주시기 바랍니다.
정책 시행 배경
과도한 API 호출로 인한 서버 부하를 방지하고, 모든 파트너사가 공정하게 서비스를 이용하며, 안정적인 응답 속도를 보장해 플랫폼 전체의 안정성과
가용성을 확보하기 위함입니다.
적용 일정
2026년 4월 1일 : 모든 클라이언트에 API 쿼터 제한 정책 전면 적용
※ 신규/기존 클라이언트 구분 없이, 유예 처리 없이 모든 파트너사에 정책이 즉시 적용됩니다.
응답 헤더 안내
API 응답에 포함되는 정책 관련 헤더를 통해 사용량을 모니터링하실 수 있습니다.
● X-Cafe24-Call-Usage : 호출 횟수 한도 대비 사용률(%)
● X-Cafe24-Call-Remain : 호출 재개 가능까지 남은 시간(초)
● X-Cafe24-Time-Usage : 처리 시간 한도 대비 사용률(%)
● X-Cafe24-Time-Remain : 처리 시간 재개 가능까지 남은 시간(초)
파트너사 필수 확인 사항
● 응답 헤더 모니터링 필수
○ X-Cafe24-Call-Usage, X-Cafe24-Time-Usage 값을 확인하여 제한 정책 도달 가능성을 사전에 파악하세요.
● Usage 80% 이상 시 호출 빈도 조절 권장
○ 100%에 도달하기 전에 선제적으로 대응해 주세요.
● 429 에러 처리 로직 구현
○ 제한 초과 시 Remain 헤더 값만큼 대기 후 재시도하는 로직을 구현해 주세요.
주요 안내 사항
● Remain 항목은 Usage가 100% 이상(자원이 전부 소진된 상태)일 때만 반환됩니다. (정상 사용 구간에서는 응답에 포함되지 않습니다)
● 제한 정책을 초과하면 해당 클라이언트의 API 호출이 최소 10분 동안 차단 됩니다.
● 차단된 상태에서 계속 호출을 시도할 경우, 재호출 가능까지 남은 시간은 더 길어질 수 있습니다.
● 따라서 서비스 영향 최소화를 위해 헤더 값을 반드시 확인 후 호출 로직을 조정 해 주시기 바랍니다.
● 쿼터 한도는 모든 쇼핑몰에 동일하게 적용되는 것이 아니며, 쇼핑몰에 따라 동적으로 제공됩니다.
4월 1일 이전에 반드시 점검 및 대응을 완료해 주시기 바랍니다.
서비스 품질 강화를 위한 정책이오니 양해 부탁드리며, 문의 사항은 기술지원팀으로 연락해 주세요.
항상 협조해 주셔서 감사합니다.