新增商品價格查詢 API，前端都可以拿到實時價格

好多商戶都遇過同一個問題：商品喺軟代後台調咗價或者開咗促銷，官網頁面上嘅價格卻仍然係寫死嘅舊數字，要手動改一遍。為咗解決呢個痛點，我哋為軟代 JS 新增咗商品價格查詢 API，令你嘅頁面價格同後台自動保持一致。

新嘅初始化方式

配合今次更新，軟代 JS 嘅接入方式亦做咗調整：現在推薦先引入腳本，再調用 window.APSDAI() 初始化，寫法更直觀，同時可以拿到實例調用 JS API。

<script src="https://i-cdn.softscdn.com/apsdai.min.js"></script>
<script>
const example = window.APSDAI({ name: 'your_merchant_code' });
</script>

要特別注意：使用實例化方式嘅時候，禁止再通過 window.Apsdai 傳入配置參數，配置只可以喺實例化參數中傳遞。原本嘅聲明式寫法（喺引入腳本之前聲明 window.Apsdai）依然可用，已經接入嘅站點唔需要改動，但兩種寫法請二選一，唔好混用。

查詢商品價格

通過實例嘅 Product.Prices() 方法就可以獲取商品資訊，第一個參數為後台商品嘅 PATH 值，第二個參數為可選嘅貨幣。

// 示例 1：使用自動貨幣選擇
example.Product.Prices('PATH1')
    .then(res => { console.log(res); })
    .catch(err => { console.log(err); });

// 示例 2：指定貨幣
example.Product.Prices('PATH1', 'usd');

// 示例 3：一次查詢多個商品
example.Product.Prices(['PATH1', 'PATH2', 'PATH3'], 'cny');

貨幣方面，國際站支援 cny、usd、twd、hkd，國內站僅支援 cny；唔傳就由系統自動選擇。

返回啲咩數據

接口以商品 PATH 為鍵返回商品資訊，包含商品名稱、規格、簡介、圖片、原價、當前售價以及是否處於促銷中：

{
    "code": 0,
    "data": {
        "PATH1": {
            "title": "測試商品",
            "sku": "規格",
            "desc": "軟件簡介",
            "images": "url",
            "original_price": 12,
            "price": 2,
            "is_promotion": true
        }
    },
    "msg": ""
}

有咗 original_price、price 同 is_promotion，你可以好方便地喺頁面上渲染劃線原價、促銷價同「限時優惠」角標，促銷開始同結束都唔需要再改動前端代碼。

使用建議

• 批量查詢：渲染商品列表嘅時候一次性傳入 PATH 數組，避免多次請求
• 價格統一維護：價格全部由後台維護，前端唔再硬編碼，減少上下架同調價失誤
• 同支付按鈕配合：查詢到嘅商品可以直接配合 data-apsdai-checkout 按鈕完成下單閉環

完整嘅參數說明同字段釋義，請查看幫助中心文檔：支付接口自定義參數。