import requests import json import os import time from datetime import datetime, timedelta # 환경변수에서 카페24 인증 정보 로드 CLIENT_ID = os.getenv("CAFE24_CLIENT_ID", "") CLIENT_SECRET = os.getenv("CAFE24_CLIENT_SECRET", "") MALL_ID = os.getenv("CAFE24_MALL_ID", "miraskitchen") REDIRECT_URI = os.getenv("CAFE24_REDIRECT_URI", "") TOKEN_FILE = "cafe24_tokens.json" def get_auth_url(): # state parameter could be added for security but keeping it simple for local app url = f"https://{MALL_ID}.cafe24api.com/api/v2/oauth/authorize" url += f"?response_type=code&client_id={CLIENT_ID}&redirect_uri={REDIRECT_URI}" url += f"&scope=mall.read_order,mall.write_order,mall.read_product" return url import base64 def _get_basic_auth_header(): credentials = f"{CLIENT_ID}:{CLIENT_SECRET}" encoded = base64.b64encode(credentials.encode('utf-8')).decode('utf-8') return f"Basic {encoded}" def request_new_token(auth_code: str): url = f"https://{MALL_ID}.cafe24api.com/api/v2/oauth/token" headers = { "Authorization": _get_basic_auth_header(), "Content-Type": "application/x-www-form-urlencoded" } data = { "grant_type": "authorization_code", "code": auth_code, "redirect_uri": REDIRECT_URI } response = requests.post(url, headers=headers, data=data) if response.status_code == 200: _save_tokens(response.json()) return True else: raise Exception(f"Failed to get token: {response.text}") def refresh_access_token(refresh_token: str): url = f"https://{MALL_ID}.cafe24api.com/api/v2/oauth/token" headers = { "Authorization": _get_basic_auth_header(), "Content-Type": "application/x-www-form-urlencoded" } data = { "grant_type": "refresh_token", "refresh_token": refresh_token } response = requests.post(url, headers=headers, data=data) if response.status_code == 200: _save_tokens(response.json()) return True else: # Refresh token might be expired. Need to re-authenticate. if os.path.exists(TOKEN_FILE): os.remove(TOKEN_FILE) raise Exception("Refresh token expired or invalid. Please re-authenticate.") def _save_tokens(token_data): # Cafe24 returns expires_at in string format like "2023-10-01T12:00:00.000" if 'expires_at' not in token_data: # Fallback if expires_at is not provided (Cafe24 provides expires_at) expires_in = token_data.get('expires_in', 7200) # usually 2 hours expires_at = datetime.now() + timedelta(seconds=expires_in - 60) # 1 min buffer token_data['expires_at'] = expires_at.isoformat() with open(TOKEN_FILE, 'w', encoding='utf-8') as f: json.dump(token_data, f) def get_valid_access_token(): if not os.path.exists(TOKEN_FILE): raise Exception("No tokens found. Please authenticate first.") with open(TOKEN_FILE, 'r', encoding='utf-8') as f: tokens = json.load(f) expires_at_str = tokens.get('expires_at') # Parse Cafe24 typical datetime format or isoformat try: if '.' in expires_at_str: # e.g. "2023-10-01T12:00:00.000" expires_at = datetime.strptime(expires_at_str[:19], "%Y-%m-%dT%H:%M:%S") else: expires_at = datetime.fromisoformat(expires_at_str) except: expires_at = datetime.now() - timedelta(minutes=1) # force refresh on parse error # Check if expired if datetime.now() >= expires_at: print("Cafe24 Access token expired, refreshing...") refresh_access_token(tokens.get('refresh_token')) return get_valid_access_token() return tokens.get('access_token') def get_cafe24_orders_count(status="N20"): token = get_valid_access_token() headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json", "X-Cafe24-Api-Version": "2026-03-01" } end_date = datetime.now().strftime("%Y-%m-%d") start_date = (datetime.now() - timedelta(days=7)).strftime("%Y-%m-%d") url = f"https://{MALL_ID}.cafe24api.com/api/v2/admin/orders/count" params = { "start_date": start_date, "end_date": end_date, "order_status": status } response = requests.get(url, headers=headers, params=params) if response.status_code == 200: return response.json().get('count', 0) return 0 def get_cafe24_orders(status="N20", progress_callback=None): """ Fetch orders with specific status (default N20: 배송준비중) """ token = get_valid_access_token() headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json", "X-Cafe24-Api-Version": "2026-03-01" } # Calculate search date range (e.g. last 7 days) end_date = datetime.now().strftime("%Y-%m-%d") start_date = (datetime.now() - timedelta(days=7)).strftime("%Y-%m-%d") url = f"https://{MALL_ID}.cafe24api.com/api/v2/admin/orders" all_orders = [] limit = 100 offset = 0 while True: params = { "start_date": start_date, "end_date": end_date, "order_status": status, "limit": limit, "offset": offset, "embed": "receivers,items" # embed items and receiver addresses } response = requests.get(url, headers=headers, params=params) if response.status_code != 200: raise Exception(f"Failed to fetch Cafe24 orders: {response.text}") json_data = response.json() orders = json_data.get('orders', []) all_orders.extend(orders) if progress_callback: progress_callback(len(all_orders)) if len(orders) < limit: break offset += limit time.sleep(0.5) # rate limit prevention return all_orders def update_cafe24_tracking(dispatch_list): """ dispatch_list is a list of dict: {"order_id": "...", "tracking_no": "...", "shipping_company_code": "0004"} Cafe24 API allows updating order shipments per order or item. Assuming we update the whole order (not item by item): PUT /api/v2/admin/orders/{order_id}/shipments """ token = get_valid_access_token() headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json", "X-Cafe24-Api-Version": "2026-03-01" } results = { "success": [], "fail": [] } for item in dispatch_list: order_id = item.get("order_id") tracking_no = item.get("tracking_no") company_code = item.get("shipping_company_code") url = f"https://{MALL_ID}.cafe24api.com/api/v2/admin/orders/{order_id}/shipments" payload = { "request": { "tracking_no": tracking_no, "shipping_company_code": company_code } } response = requests.put(url, headers=headers, json=payload) if response.status_code in [200, 201]: results["success"].append(order_id) else: reason = "Unknown Error" try: err_data = response.json() reason = err_data.get('error', {}).get('message', response.text) except: reason = response.text results["fail"].append({ "order_id": order_id, "reason": reason }) time.sleep(0.3) # API rate limit return results def get_product_details(product_no): """ Fetch product details to get custom product codes/seller codes """ token = get_valid_access_token() headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json", "X-Cafe24-Api-Version": "2026-03-01" } url = f"https://{MALL_ID}.cafe24api.com/api/v2/admin/products/{product_no}?embed=variants" response = requests.get(url, headers=headers) if response.status_code == 200: return response.json().get('product', {}) return {}