1. 接口基礎信息

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

請求方式：GET

請求地址：https://openapi-fxg.jinritemai.com/product/detail

權限要求：需店鋪授權 + 應用具備「商品信息查詢」權限

2. 公共請求參數（必填）

表格

3. 業務參數（param_json）

表格

4. 核心返回字段（JSON）

基礎信息：product_id、name（標題）、description（詳情 HTML）、pic（主圖列表）、status（上下架）、check_status（審核狀態）

價格：market_price（劃線價，分）、discount_price（售價，分）、spec_prices（SKU 價格）

規格：specs（規格項）、spec_prices（SKU 詳情）

銷售：sell_num（銷量）、presell_type（預售類型）、delivery_method（發貨時效）

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

5. 請求示例

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

二、抖音開放平臺：商品相關接口（非抖店）

1. 生活服務商品模板（goodlife/v1/goods/template/get）抖音開放平臺

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

權限：需申請「商品查詢」權限 + 商家授權抖音開放平臺

參數：product_type（商品類型）、category_id（類目 ID）、product_attrs（屬性列表）抖音開放平臺

2. 其他場景

達人 / 選品：巨量百應（Buyin）提供 buyin/productSkus/v2 等分銷商品查詢接口

小程序 / 應用：抖音開放平臺提供商品展示、掛載相關能力，需按場景申請權限抖音開放平臺

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

入駐：在抖店開放平臺注冊開發者，創建應用獲取 app_key/app_secret

授權：引導抖店商家完成應用授權，獲取 access_token

簽名：按規則對參數簽名（推薦 hmac-sha256）

調用：傳入 product_id 或 out_product_id 發起請求

解析：處理 JSON 返回，提取商品詳情、價格、SKU 等數據

四、常見錯誤與注意事項

40004：參數非法（商品 ID 不存在 / 格式錯誤）

50002：業務失敗（限流、權限不足）

20000：系統異常（重試）

限流：接口有調用頻率限制，需合理控制并發

數據：價格單位為分，詳情為 HTML 格式，主圖最多 5 張

五、應用場景

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

導購 / 選品：聚合商品詳情、價格、銷量做推薦

數據分析：監控商品價格、銷量、庫存變化

直播 / 短視頻：自動掛載商品、展示詳情

審核編輯 黃宇