1. 接口基礎(chǔ)信息

接口名稱：product.detail（查詢商品詳情）

請(qǐng)求方式：GET

請(qǐng)求地址：https://openapi-fxg.jinritemai.com/product/detail

權(quán)限要求：需店鋪授權(quán) + 應(yīng)用具備「商品信息查詢」權(quán)限

2. 公共請(qǐng)求參數(shù)（必填）

表格

3. 業(yè)務(wù)參數(shù)（param_json）

表格

4. 核心返回字段（JSON）

基礎(chǔ)信息：product_id、name（標(biāo)題）、description（詳情 HTML）、pic（主圖列表）、status（上下架）、check_status（審核狀態(tài)）

價(jià)格：market_price（劃線價(jià)，分）、discount_price（售價(jià)，分）、spec_prices（SKU 價(jià)格）

規(guī)格：specs（規(guī)格項(xiàng)）、spec_prices（SKU 詳情）

銷售：sell_num（銷量）、presell_type（預(yù)售類型）、delivery_method（發(fā)貨時(shí)效）

其他：category_detail（類目）、logistics_info（物流）、after_sale_service（售后）

5. 請(qǐng)求示例

plaintext

https://openapi-fxg.jinritemai.com/product/detail?app_key=xxx&method=product.detail&access_token=xxx?m_json={"product_id":"3558192687276554544"}×tamp=2026-03-23 10:00:00&v=2&sign=xxx

二、抖音開放平臺(tái)：商品相關(guān)接口（非抖店）

1. 生活服務(wù)商品模板（goodlife/v1/goods/template/get）抖音開放平臺(tái)

用途：獲取生活服務(wù)類商品模板信息

權(quán)限：需申請(qǐng)「商品查詢」權(quán)限 + 商家授權(quán)抖音開放平臺(tái)

參數(shù)：product_type（商品類型）、category_id（類目 ID）、product_attrs（屬性列表）抖音開放平臺(tái)

2. 其他場景

達(dá)人 / 選品：巨量百應(yīng)（Buyin）提供 buyin/productSkus/v2 等分銷商品查詢接口

小程序 / 應(yīng)用：抖音開放平臺(tái)提供商品展示、掛載相關(guān)能力，需按場景申請(qǐng)權(quán)限抖音開放平臺(tái)

三、接入流程（抖店為例）

入駐：在抖店開放平臺(tái)注冊(cè)開發(fā)者，創(chuàng)建應(yīng)用獲取 app_key/app_secret

授權(quán)：引導(dǎo)抖店商家完成應(yīng)用授權(quán)，獲取 access_token

簽名：按規(guī)則對(duì)參數(shù)簽名（推薦 hmac-sha256）

調(diào)用：傳入 product_id 或 out_product_id 發(fā)起請(qǐng)求

解析：處理 JSON 返回，提取商品詳情、價(jià)格、SKU 等數(shù)據(jù)

四、常見錯(cuò)誤與注意事項(xiàng)

40004：參數(shù)非法（商品 ID 不存在 / 格式錯(cuò)誤）

50002：業(yè)務(wù)失?。ㄏ蘖鳌?quán)限不足）

20000：系統(tǒng)異常（重試）

限流：接口有調(diào)用頻率限制，需合理控制并發(fā)

數(shù)據(jù)：價(jià)格單位為分，詳情為 HTML 格式，主圖最多 5 張

五、應(yīng)用場景

ERP / 商品管理：同步抖店商品信息、上下架、庫存

導(dǎo)購 / 選品：聚合商品詳情、價(jià)格、銷量做推薦

數(shù)據(jù)分析：監(jiān)控商品價(jià)格、銷量、庫存變化

直播 / 短視頻：自動(dòng)掛載商品、展示詳情

審核編輯 黃宇