ecommerce-apilisted

# e-Commerce API — 마켓플레이스 API 통합 ## 사용 시기 - "쿠팡 API", "네이버 API", "아마존 API", "쇼피파이", "마켓플레이스 연동" 요청 시 ## 지원 마켓플레이스 ### 국내 | 플랫폼 | API 유형 | 인증 | 주요 기능 | |--------|----------|------|-----------| | 쿠팡 (WING) | REST | HMAC-SHA256 | 상품등록, 주문관리, 배송, 정산 | | 네이버 스마트스토어 | REST | OAuth 2.0 | 상품, 주문, 정산, 톡톡 | | 11번가 | REST | API Key | 상품, 주문, 배송 | | G마켓/옥션 | REST | API Key | ESM+ 통합 API | | 카카오 쇼핑 | REST | OAuth 2.0 | 톡스토어 연동 | | 위메프/티몬/인터파�� | REST | API Key | 상품/주문 | ### 해외 | 플랫폼 | API 유형 | 인증 | 주요 기능 | |--------|----------|------|-----------| | Amazon (SP-API) | REST | OAuth 2.0 + IAM | 글로벌 셀링 전체 | | Shopify | GraphQL/REST | OAuth 2.0 | 독립몰 완전 통합 | | eBay | REST | OAuth 2.0 | 글로벌 셀링 | | Shopee | REST | HMAC | 동남아 | | Lazada | REST | Token | 동남아 | | AliExpress | REST | Token | 글로벌 소싱 | ## API 통합 원칙 1. **어댑터 패턴** — 각 마켓플레이스 API를 통일된 인터페이스로 래핑 2. **Rate Limiting** — 각 API의 호출 제한 준수 (큐 기반 처리) 3. **웹훅 우선** — 폴링 대신 웹훅으로 실시간 동기화 4. **재시도 전략** — 지수 백오프 + 최대 재시도 횟수 ���정 5. **토큰 관리** — 자동 갱신, 만료 전 사전 갱신, 안전한 저장 ## 통합 API 인터페이스 (예시) ```typescript interface MarketplaceAdapter { // 상품 listProducts(params: ListParams): Promise<Product[]> createProduct(product: ProductInput): Promise<Product> updateProduct(id: string, product: Partial<ProductInput>): Promise<Product> // 주문 listOrders(params: OrderListParams): Promise<Order[]> getOrder(orderId: string): Promise<Order> updateOrderStatus(orderId: string, status: OrderStatus): Promise<void> // 재고 updateStock(sku: string, qu