shopee-sdk
輕量級、功能完整的 TypeScript SDK,專為 Shopee Open API v2 設計。具備自動請求簽章、可插拔的權杖儲存、穩健的錯誤處理,以及
shopee-sdk 是什麼?
輕量級、功能完整的 TypeScript SDK,專為 Shopee Open API v2 設計。具備自動請求簽章、可插拔的權杖儲存、穩健的錯誤處理,以及 100% 端點覆蓋率。
shopee-sdk 概覽
這是什麼
Shopee SDK 是一個輕量級、功能完整的 TypeScript SDK,用於 Shopee Open API v2。它提供自動請求簽章、可插拔的令牌儲存、穩健的錯誤處理,以及 100% 的端點覆蓋率。此 SDK 採用 MIT 授權,為開源且專為生產環境設計。
主要功能
- 自動請求簽章與令牌重新整理
- 可插拔的令牌儲存(內建檔案儲存,支援自訂方案)
- 穩健的錯誤處理與內建重試邏輯
- 100% 覆蓋所有 Shopee API 端點,共 30 個 API 管理器
- 完整的 TypeScript 定義,提供型別安全與自動完成
- 支援所有 12 個 Shopee 區域
- 除 node-fetch 外無其他依賴
使用情境
- 多渠道電子商務平台 – 跨銷售管道同步庫存、訂單與商品
- 分析儀表板 – 追蹤銷售表現與業務指標
- 自動化工具 – 自動處理訂單、庫存更新與客戶溝通
- ERP 整合 – 將 Shopee 連接到現有業務系統
- 行動應用程式 – 建立原生的商店管理體驗
- 行銷自動化 – 程式化管理促銷、優惠券與廣告活動
快速開始
安裝套件:bashnpm install @congminh1254/shopee-sdk需求:Node.js >= 20.0.0快速開始範例:```typescriptimport { ShopeeSDK, ShopeeRegion } from '@congminh1254/shopee-sdk';const sdk = new ShopeeSDK({ partner_id: 123456, partner_key: 'your-partner-key', region: ShopeeRegion.GLOBAL, shop_id: 789012,});const authUrl = sdk.getAuthorizationUrl('https://your-app.com/callback');console.log('Visit:', authUrl);await sdk.authenticateWithCode('auth-code-from-callback');const products = await sdk.product.getItemList({ offset: 0, page_size: 20 });const orders = await sdk.order.getOrderList({ time_range_field: 'create_time', time_from: Math.floor(Date.now() / 1000)
- 86400, time_to: Math.floor(Date.now() / 1000), page_size: 50,});```
授權與價格
授權:MIT。此 SDK 為開源且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。