CAFE24 API 시작하기

CAFE24 API를 사용하면 쇼핑몰의 상품, 주문, 회원 등 다양한 데이터를 프로그래밍 방식으로 관리할 수 있습니다.

API 개요

항목	내용
Base URL	https://{mall_id}.cafe24api.com/api/v2
프로토콜	HTTPS (TLS 1.2 이상)
인증 방식	OAuth 2.0
응답 형식	JSON
문자 인코딩	UTF-8

빠른 시작

1. 앱 등록

CAFE24 개발자 센터에서 앱을 등록하고 Client ID와 Client Secret을 발급받습니다.

2. Access Token 발급

curl -X POST "https://{mall_id}.cafe24api.com/api/v2/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "code={authorization_code}" \
  -d "redirect_uri={redirect_uri}" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}"

3. API 호출

curl -X GET "https://{mall_id}.cafe24api.com/api/v2/admin/products" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json"

4. 응답 확인

{
  "products": [
    {
      "product_no": 1,
      "product_name": "샘플 상품",
      "price": "10000.00",
      "created_date": "2024-01-15T09:00:00+09:00"
    }
  ]
}

API 종류

Admin API

쇼핑몰 관리자용 API입니다. 상품 등록, 주문 관리, 회원 관리 등 관리자 기능을 제공합니다.

• 상품 관리 (Products)
• 주문 관리 (Orders)
• 회원 관리 (Customers)
• 카테고리 관리 (Categories)

Front API

쇼핑몰 프론트용 API입니다. 상품 조회, 장바구니, 주문 등 고객 기능을 제공합니다.

• 상품 조회
• 장바구니
• 주문/결제

인증 (OAuth 2.0)

CAFE24 API는 OAuth 2.0 인증을 사용합니다.

┌─────────┐     1. 인증 요청      ┌─────────────┐
│   App   │ ──────────────────▶ │   CAFE24    │
│         │                     │   OAuth     │
│         │ ◀────────────────── │   Server    │
└─────────┘  2. Access Token    └─────────────┘
     │
     │ 3. API 호출 (Bearer Token)
     ▼
┌─────────────┐
│   CAFE24    │
│   API       │
└─────────────┘

Token 종류

Token	유효기간	용도
Access Token	2시간	API 호출 시 인증
Refresh Token	14일	Access Token 갱신

Rate Limit

API 호출에는 총량 제한(쿼터)과 순간 유량 제한이 함께 적용됩니다. 별도로 설정하지 않는 한 다음 값이 기본 적용됩니다:

구분	제한
10분당 호출 수	3,000회
10분당 호출 시간	600초

제한을 초과하면 429 Too Many Requests 응답이 반환됩니다. 자세한 내용은 API 쿼터 가이드를 참고하세요.

에러 처리

HTTP 상태 코드

코드	설명
200	성공
201	생성 성공
400	잘못된 요청
401	인증 실패
403	권한 없음
404	리소스 없음
429	Rate Limit 초과
500	서버 오류

에러 응답 형식

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "필수 파라미터가 누락되었습니다.",
    "more_info": "https://developers.cafe24.com/errors/INVALID_REQUEST"
  }
}

다음 단계

• OAuth 인증 가이드 - 상세 인증 가이드
• 에러 코드 목록 - 전체 에러 코드