카페24로 쇼핑몰을 운영하다 보면 같은 데이터를 여러 곳에 옮기는 일이 쌓여요. 새 주문을 정산표에 옮기고, 품절 상품을 재고표에서 지우고, 큰 주문이 들어오면 담당자에게 알리는 일이죠. 카페24는 이런 연결을 위해 공식 API를 제공해요. 저희도 카페24 API 연동 개발을 해 봤고, 그 과정에서 처음부터 정해 두면 좋았던 순서를 정리했어요.
1. 어떤 데이터를 어디로 옮길지부터
API(프로그램끼리 데이터를 주고받는 통로)를 고르기 전에, 옮길 데이터와 받을 곳을 먼저 적어 보는 게 좋아요. 카페24 공식 가이드는 API를 두 가지로 나눠 설명해요.
| 구분 | 공식 설명 | 이럴 때 |
|---|---|---|
| Admin API | 쇼핑몰 관리자용 — 상품 · 주문 · 회원 · 분류 관리 | 주문을 정산표로, 상품 정보를 재고표로 |
| Front API | 쇼핑몰 화면용 — 상품 조회 · 장바구니 · 주문/결제 | 다른 화면에서 상품을 보여 줄 때 |
업무 자동화는 대부분 Admin API에서 시작해요. "주문이 들어오면 무엇을, 어디에, 얼마나 자주" 옮길지 한 줄씩 적어 두면 뒤의 권한과 호출 횟수를 정하기 쉬워져요.
2. 앱 등록과 OAuth 인증 흐름
카페24 API를 쓰려면 먼저 카페24 개발자센터에 앱을 등록해 인증 정보를 받아요. 그다음 쇼핑몰 운영자가 허락하는 과정을 거치는데, 이를 OAuth 2.0 인증(내 비밀번호를 넘기지 않고 앱에 권한만 빌려주는 방식)이라고 해요. 공식 가이드의 흐름은 이래요.
- 인증 코드 요청: 웹 브라우저에서 요청해요. 받은 인증 코드는 1분 동안, 한 번만 쓸 수 있어요.
- Access Token 발급: 인증 코드로 실제 API 호출에 쓰는 토큰을 받아요. 이 요청은 서버(백엔드)에서 해야 해요.
- 토큰 유효 기간: Access Token은 2시간, Refresh Token(새 토큰을 다시 받는 열쇠)은 2주예요.
인증 뒤에 돌아올 주소(Redirect URI)는 개발자센터에 미리 등록하고, 토큰을 요청할 때도 같은 주소를 보내야 해요. 공식 가이드는 항상 HTTPS를 쓰라고 안내해요.
3. 권한은 필요한 만큼만
인증할 때 어떤 데이터에 접근할지 권한 범위(scope)를 함께 정해요. 공식 예시에는 mall.read_order(주문 읽기), mall.read_product(상품 읽기) 같은 이름이 나와요.
주문을 읽어서 정산표로 옮기기만 한다면 읽기 권한만 받는 게 맞아요. 쓰기 권한까지 받아 두면 실수 한 번이 실제 쇼핑몰 데이터를 바꿀 수 있거든요. 처음에는 읽기로 시작하고, 상품 수정처럼 꼭 필요한 기능이 생길 때 권한을 늘리는 순서를 권해요.
우리 회사 자료로 직접 확인해 보고 싶다면AI 도입 진단 · 자료를 보고 적용 후보와 순서를 정리해 드려요상담 신청4. 호출 한도와 토큰 갱신을 처음부터 설계하기
카페24 API 시작 가이드에는 초당 10회, 분당 300회 호출 한도가 나와 있고, 넘으면 429 Too Many Requests 응답이 돌아온다고 안내해요. 주문이 몰리는 날 한 번에 많은 데이터를 옮기려다 이 한도에 걸리기 쉬워요.
- 요청을 대기열에 쌓아 한도 안에서 차례로 보내기
- 429가 오면 잠깐 기다렸다가 다시 보내기
- Access Token이 2시간 만에 끝나니 만료 전에 미리 갱신하기
- 갱신이 실패하면 담당자에게 바로 알림 보내기
이 네 가지를 처음 설계에 넣어 두면 "어제까지 잘 되던 연동이 갑자기 멈췄다"는 일을 크게 줄일 수 있어요.
연동 뒤에 붙일 수 있는 AI 기능(선택)
데이터가 안정적으로 들어오기 시작하면 AI 기능을 붙이는 것도 고려해 볼 만해요. 예를 들어 상품 정보로 상품 설명 초안을 만들어 담당자가 다듬게 하거나, 고객 문의를 배송 · 교환 · 상품 질문으로 분류해 담당자에게 나눠 주는 식이에요. 이런 기능은 연동이 먼저 안정된 뒤에 옵션으로 붙이는 게 순서예요.
연동 전 체크리스트
- 옮길 데이터와 받을 시스템을 한 줄씩 적었나요
- 개발자센터 앱 등록 · Redirect URI 등록
- 권한(scope)은 읽기부터 최소로
- 호출 한도 · 토큰 갱신 · 실패 알림을 설계에 넣었나요
참고
- 카페24 개발자센터, OAuth 2.0 인증 가이드: https://developers.cafe24.com/docs-new/docs/guide/oauth2-authentication
- CAFE24 Developers, Getting Started with CAFE24 API: https://developers.cafe24.com/docs-new/en/docs/guide/intro
웹 · 앱 · 업무 시스템을 만들고 그 위에 필요한 AI를 붙여 운영하는 팀이에요. 회의록 · 계약서 · 기업 분석 AI를 직접 만들어 운영해요.
만든 프로젝트 보기