Page History

...

• https://developers.cafe24.com/app/front/app/develop/api/operation

카페24 공지사항

API 요청 수 제한 정책

• 카페24는 API 요청을 Bucket에 쌓아두었다가, Bucket이 가득 차면 요청을 제한하는 방식인
  "Leaky Bucket" 알고리즘을 사용하고 있습니다.

Image Added

물을 담는 구멍 난 양동이를 상상해보세요.

• 🧑‍💻 API 요청 = 물

• 🪣 버킷 = 요청 저장 공간

• 🕳️ 구멍 = 일정 속도로 빠져나가는 처리 속도

흐름

1. 요청이 들어오면 → 버킷에 저장

2. 버킷은 일정한 속도로만 요청을 처리

Image Added

1. 입구에서 유체가 들어옵니다.

2. 압력이 낮으면 → 밸브가 열려서 정상 흐름 유지

3. 압력이 높아지면 →

   • 스프링을 밀어 올리면서

   • 밸브가 닫히기 시작

4. 결과적으로 입구 쪽 압력이 올라가면서 유입이 줄어듭니다

Leaky Bucket은
→ 넘치면 잘라버리는 방식(차단)

Backpressure는
→ 넘치기 전에 속도를 조절하는 방식(제어)

즉,
❌ 버리는 게 아니라
✅ 흐름을 조절합니다.

공개호스트 - OpenHostService

이 프로토콜은 공개가 되어있고 이용하기위한 문서화가 잘되어 있으며 이것을 이용하는 팀은 상류 API를 그대로 이용을 해야합니다.

페이스북의 공개된 API를 이용하여 로그인 기능을 만들거나 정부 OpenAPI를 이용하여 기능을 개발하는경우

개발팀은 제공되는 API를 그대로 준수하고 따릅니다. 상류 제공 API팀은 전체 의견을 수렴해 기능개선을 할수도 있지만

특정팀의 의견을 위해 기능변경을 하지 않습니다.

순응적 패턴

언제 무엇을 받게될지 상류(Upstream)인 공급자(Provider)가 주로 결정을 하지고

이것을 제공받는 하류(DownStream)팀은 상류 스트림을 준수합니다. 

공개호스트와는 다르게 하류팀의 요구사항을 받아들이기도합니다.

Cafe24 API의 경우 대부분 공개호스트이지만, 협약되어 제공되는 API가 있을수 있습니다.

협약관계 또는 상류의 기능이 오류가있거나 개선이 필요할시 공급받는 다운스트림에서 개선요청을 할수도 있습니다.

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