微信小程序 服務(wù)端接口·商品管理接口

【小程序直播】直播商品管理接口

一、簡(jiǎn)介

直播商品管理接口，是小程序直播提供給開發(fā)者對(duì)直播商品進(jìn)行批量操作的接口能力。

開發(fā)者可以對(duì)商品批量進(jìn)行添加、提審、刪除以及更新等操作。

接口僅支持對(duì)通過(guò)接口添加的商品進(jìn)行操作，開發(fā)者在小程序管理后臺(tái)添加的商品，不支持通過(guò)接口操作。

開發(fā)者必須保存【商品ID】與【審核單ID】，如果丟失，則無(wú)法調(diào)用其他相關(guān)接口。

二、接口文檔

1.商品添加并提審

接口說(shuō)明

調(diào)用此接口上傳并提審需要直播的商品信息，審核通過(guò)后商品錄入【小程序直播】商品庫(kù)

注意：開發(fā)者必須保存【商品ID】與【審核單ID】，如果丟失，則無(wú)法調(diào)用其他相關(guān)接口

調(diào)用頻率

調(diào)用額度：500次/一天

請(qǐng)求方法

POST

請(qǐng)求URL

https://api.weixin.qq.com/wxaapi/broadcast/goods/add?access_token=

請(qǐng)求參數(shù)示例： json

{    
    "goodsInfo": {              
         "coverImgUrl": "ZuYVNKk9sMP1X4m7FXdcDCKra251KDZTjS502UTV7gwalgLZXcrOhG6oNYX6c7AR",        
         "name":"TIT茶杯",      
         "priceType":1,   
         "price":99.5,
         // "price2": 150.5, priceType為2或3時(shí)必填
         "url":"pages/index/index"  
    }
}

請(qǐng)求參數(shù)含義

正確返回示例

{  
    "goodsId": 51,
    "auditId": 525022786,
    "errcode": 0 
}

返回參數(shù)含義

2.撤回審核

接口說(shuō)明

調(diào)用此接口，可撤回直播商品的提審申請(qǐng)，消耗的提審次數(shù)不返還

調(diào)用頻率

調(diào)用額度：500次/一天

請(qǐng)求方法

POST

請(qǐng)求URL

https://api.weixin.qq.com/wxaapi/broadcast/goods/resetaudit?access_token=

請(qǐng)求參數(shù)示例： json

{    
    "auditId": 525022184,
    "goodsId": 9
}

請(qǐng)求參數(shù)含義

正確返回示例

{  
    "errcode": 0 
}

3.重新提交審核

接口說(shuō)明

調(diào)用此接口可以對(duì)已撤回提審的商品再次發(fā)起提審申請(qǐng)

調(diào)用頻率

調(diào)用額度：500次/一天（與接口1共用500次限制）

請(qǐng)求方法

POST

請(qǐng)求URL

https://api.weixin.qq.com/wxaapi/broadcast/goods/audit?access_token=

請(qǐng)求參數(shù)示例： json

{    
    "goodsId": 9
}

請(qǐng)求參數(shù)含義

正確返回示例

{  
    "errcode": 0,
    "auditId": 525022184
}

返回參數(shù)含義

4.刪除商品

接口說(shuō)明

調(diào)用此接口，可刪除【小程序直播】商品庫(kù)中的商品，刪除后直播間上架的該商品也將被同步刪除，不可恢復(fù)；

調(diào)用頻率

調(diào)用額度：1000次/一天

請(qǐng)求方法

POST

請(qǐng)求URL

https://api.weixin.qq.com/wxaapi/broadcast/goods/delete?access_token=

請(qǐng)求參數(shù)示例： json

{    
    "goodsId": 9
}

請(qǐng)求參數(shù)含義

返回參數(shù)

{   
    "errcode": 0,   
}

5.更新商品

接口說(shuō)明

調(diào)用此接口可以更新商品信息，審核通過(guò)的商品僅允許更新價(jià)格類型與價(jià)格，審核中的商品不允許更新，未審核的商品允許更新所有字段， 只傳入需要更新的字段。

調(diào)用頻率

調(diào)用額度：1000次/一天

請(qǐng)求方法

POST

請(qǐng)求URL

https://api.weixin.qq.com/wxaapi/broadcast/goods/update?access_token=

請(qǐng)求參數(shù)示例： json

{    

    "goodsInfo": {        
        // 需要更新哪個(gè)字段就傳入哪個(gè)字段，goodsId 必傳        
        "coverImgUrl": "ZuYVNKk9sMP1X4m7FXdcDCKra251KDZTjS502UTV7gwalgLZXcrOhG6oNYX6c7AR",        
        "name":"TIT茶杯",        
        "priceType":1,
        "price":99.5,
        // "price2": 150.5, priceType為2或3時(shí)必填
        "url": "pages/index/index",       
        "goodsId": 9     
    }
}

請(qǐng)求參數(shù)含義

返回參數(shù)

{   
    "errcode": 0,   
}

6.獲取商品狀態(tài)

接口說(shuō)明

調(diào)用此接口可獲取商品的信息與審核狀態(tài)

調(diào)用頻率

調(diào)用額度：1000次/一天

請(qǐng)求方法

POST

請(qǐng)求URL

https://api.weixin.qq.com/wxa/business/getgoodswarehouse?access_token=

請(qǐng)求參數(shù)示例： json

{
?    "goods_ids": [1]
}

請(qǐng)求參數(shù)含義

返回參數(shù)

{
?    "errcode":0,
?    "errmsg":"ok",
?    "goods":
?        [
?            {
?                "goods_id":9,
?                "cover_img_url":"xxxx",
?                "name":"xxxxx"
?                "price":12300,
?                "url":"xxxxxxx",
?                "price_type":1,
?                "price2":0,
?                "audit_status":1,
?                "third_party_tag":0
?            }
?        ],
?    "total":0
}

返回參數(shù)含義

7.獲取商品列表

接口說(shuō)明

調(diào)用此接口可獲取商品列表

調(diào)用頻率

調(diào)用額度：10000次/一天

請(qǐng)求方法

GET

請(qǐng)求URL

https://api.weixin.qq.com/wxaapi/broadcast/goods/getapproved?access_token=[access_token]

URL query 參數(shù)

返回參數(shù)

{
?    "errcode":0,
?    "total":68,
?    "goods":
?        [
?            {
?                "goodsId":9,
?                "coverImgUrl":"xxxx",
?                "name":"xxxxx"
?                "price":12300,
?                "url":"xxxxxxx",
?                "priceType":1,
?                "price2":0,
?                "thirdPartyTag":0
?            }
?        ]
}

返回參數(shù)含義

附錄：錯(cuò)誤碼

-1：系統(tǒng)錯(cuò)誤

1003：商品id不存在

47001：入?yún)⒏袷讲环弦?guī)范

200002：入?yún)㈠e(cuò)誤

300001：禁止創(chuàng)建/更新商品（如：商品創(chuàng)建功能被封禁）

300002：名稱長(zhǎng)度不符合規(guī)則

300003：價(jià)格輸入不合規(guī)（如：現(xiàn)價(jià)比原價(jià)大、傳入價(jià)格非數(shù)字等）

300004：商品名稱存在違規(guī)違法內(nèi)容

300005：商品圖片存在違規(guī)違法內(nèi)容

300006：圖片上傳失?。ㄈ纾簃ediaID過(guò)期）

300007：線上小程序版本不存在該鏈接

300008：添加商品失敗

300009：商品審核撤回失敗

300010：商品審核狀態(tài)不對(duì)（如：商品審核中）

300011：操作非法（API不允許操作非API創(chuàng)建的商品）

300012：沒有提審額度（每天500次提審額度）

300013：提審失敗

300014：審核中，無(wú)法刪除（非零代表失?。?/p>

300017：商品未提審

300021：商品添加成功，審核失敗