微信商品管理

2019-03-14 11:48 更新

商品管理

目錄

1 商品管理

1.1 查詢商品信息

1.2 批量查詢商品信息

1.3 更新商品信息

1.4 清除商品信息

1.5 跳轉(zhuǎn)URL參數(shù)說(shuō)明

1.6 檢查wxticket參數(shù)

1.7 組件消息

1.8 清除掃碼記錄


商品管理

查詢商品信息

調(diào)用該接口,商戶可以查詢創(chuàng)建成功的商品信息,用以檢查商品狀態(tài)或信息設(shè)置情況。

請(qǐng)求示例

HTTP請(qǐng)求方式:POST
https://api.weixin.qq.com/scan/product/get?access_token=access_token
POST數(shù)據(jù)格式:JSON
POST數(shù)據(jù)例子:
{
 "keystandard": "ean13",
 "keystr": "6900873042720"
}	

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token公眾號(hào)的全局憑據(jù),用于接口調(diào)用。
keystandard商品編碼標(biāo)準(zhǔn)。
keystr商品編碼內(nèi)容。

返回示例

正確的JSON返回結(jié)果如下:

{
 "errcode": 0,
 "errmsg": "ok",
 "brand_info":{
  "base_info":{
   "title": "掃一掃動(dòng)態(tài)主頁(yè)demo",
"thumb_url":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNrX6Yrvd7LzKERyic3kn3VdSsmFr5F5ibXzj9Al65yWFudmjqcWic1Qe9g/0",
   "brand_tag": "小耿哥8",
   "category_id": 0,
   "retail_price": "0.00",
   "store_mgr_type": "auto",
   "store_vendorid_list":[],
   "color": "auto",
   "status": "on"
  },
  "detail_info":{
   "banner_list":[
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNic0LvlkCw7s6mZpicib7ict5MhoiaL3gPrYXpibnibOpViaYJFpic12nx4bNZcQ/0"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNbTfwJmlVXp9k1A80UCFL1a9icwdthmSLh0RuJ5iaKcZBwdXbOicktkwPQ/0"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNW4FD74oXjEyqHicE9U3H0nTCdLHibo7rRia2TFBQ6tx2Pvic92ica8Wns4Q/0"}
   ],
   "detail_list":[
    {
     "title": "產(chǎn)品名稱",
     "desc": "微信相框moment"
    },
    {
     "title": "設(shè)計(jì)團(tuán)隊(duì)",
     "desc": "微信團(tuán)隊(duì)"
    },
    {
     "title": "設(shè)計(jì)初衷",
     "desc": "做一個(gè)簡(jiǎn)單純粹的電子相框"
    },
    {
     "title": "產(chǎn)品訴求",
     "desc": "以相框?yàn)榧~帶,增加子女與父母長(zhǎng)輩的溝通,用照片通過(guò)微信傳遞感情交流"
    }
   ]
  },
  "action_info":{
   "action_list":[
    {
     "type": "link",
     "name": "banner",
     "link": "http://mp.weixin.qq.com",
"image":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNgjXTKn0j4TlfXjUOPYBDicVOmG0sdNfUOg9Lzia2g9cbjyTXmOiaB6L1g/0",
     "showtype": "banner"
    },
    {
     "type": "link",
     "name": "自定義活動(dòng)1",
     "link": "http://p.url.cn/wxscan.php",
    },
    {
     "type": "link",
     "name": "自定義活動(dòng)2",
     "link": "http://p.url.cn/wxscan.php",
    },
    {
     "type": "user",
     "appid": "wx307e399609946068"
    },
    {
     "type": "text",
     "text": "此處可根據(jù)品牌商需要,用于簡(jiǎn)單描述商品或活動(dòng)。"
    }
   ]
  },
  "module_info":{
   "module_list":[
    {
     "type": "anti_fake",
     "native_show": "true"
    }
   ]
  }
 }
}

返回參數(shù)說(shuō)明

參數(shù)說(shuō)明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。
status商品主頁(yè)的狀態(tài),on為發(fā)布狀態(tài),off為未發(fā)布狀態(tài),check為審核中狀態(tài),reject為審核未通過(guò)狀態(tài)。

其他參數(shù)說(shuō)明,請(qǐng)參考“創(chuàng)建商品”接口。

注意:商品狀態(tài)(status)處于“審核中(check)”的商品,不可調(diào)用接口進(jìn)行更新或取消發(fā)布,否則會(huì)報(bào)錯(cuò)。

批量查詢商品信息

調(diào)用該接口,商戶可以批量查詢創(chuàng)建成功的商品信息,查詢維度有商品狀態(tài)和編碼內(nèi)容。

請(qǐng)求示例

HTTP請(qǐng)求方式:POST
https://api.weixin.qq.com/scan/product/getlist?access_token=access_toke
POST數(shù)據(jù)格式:JSON
POST數(shù)據(jù)例子:
{
 "offset": "1",
 "limit": "10",
 "status":"on",
}

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token公眾號(hào)的全局憑據(jù),用于接口調(diào)用。
offset批量查詢的起始位置,從0開(kāi)始,包含該起始位置。
limit批量查詢的數(shù)量。
status支持按狀態(tài)拉取。on為發(fā)布狀態(tài),off為未發(fā)布狀態(tài),check為審核中狀態(tài),reject為審核未通過(guò)狀態(tài),all為所有狀態(tài)。
keystr支持按部分編碼內(nèi)容拉取。填寫(xiě)該參數(shù)后,可將編碼內(nèi)容中包含所傳參數(shù)的商品信息拉出。類似關(guān)鍵詞搜索。

返回示例

正確的JSON返回結(jié)果如下:

{
 "errcode": 0,
 "errmsg": "ok",
 "total": 2,
 "key_list": [
  {
   "keystandard": "ean13",
   "keystr": "6390000000000",
   "category_id": 537117576,
   "category_name": "果泥/菜泥/肉泥",
   "update_time": 1413181580,
   "status": "on"
  },
  {
   "keystandard": "ean13",
   "keystr": "6390000000002",
   "category_id": 537117576,
   "category_name": "果泥/菜泥/肉泥",
   "update_time": 1412834605,
   "status": "on"
  }
 ]
}

返回參數(shù)說(shuō)明

參數(shù)說(shuō)明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。
total命中篩選條件的商品總數(shù)。
key_list商品信息列表。
keystandard商品編碼標(biāo)準(zhǔn)。
keystr商品編碼內(nèi)容。
category_id商品類目ID。
category_name商品類目名稱。
update_time商品信息的最后更新時(shí)間(整型)。
status商品主頁(yè)的狀態(tài),on為發(fā)布狀態(tài),off為未發(fā)布狀態(tài),check為審核中狀態(tài),reject為審核未通過(guò)狀態(tài)。

更新商品信息

調(diào)用該接口,可對(duì)商品的基本信息(base_info)、詳情信息(detail_info)、推廣服務(wù)區(qū) (action_info)和組件區(qū)(modul_info)四部分進(jìn)行獨(dú)立或整體的更新。

注意:對(duì)處于“發(fā)布狀態(tài)(on)”的商品進(jìn)行更新,調(diào)用接口成功后,新的商品信息會(huì)自動(dòng)進(jìn)入掃一掃審核系統(tǒng)。對(duì)“審核中(check)”的商品,不可再更新或取消發(fā)布,否則會(huì)報(bào)錯(cuò)。

請(qǐng)求示例

HTTP請(qǐng)求方式:POST
https://api.weixin.qq.com/scan/product/update?access_token=access_token 
POST數(shù)據(jù)格式:JSON
POST數(shù)據(jù)例子:
{
 "keystandard": "ean13",
 "keystr": "6390000000000",
 "brand_info": {
  "action_info": {
   "action_list": [
    {
     "type": "link",
     "name": "banner",
     "link":"http://mp.weixin.qq.com",
"image":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNgjXTKn0j4TlfXjUOPYBDicVOmG0sdNfUOg9Lzia2g9cbjyTXmOiaB6L1g/0",
     "showtype": "banner"
    },
    {
     "type": "link",
     "name": "更新的自定義活動(dòng)1",
     "link": "http://p.url.cn/wxscan.php",
    },
    {
     "type": "link",
     "name": "更新的自定義活動(dòng)2",
     "link": "http://p.url.cn/wxscan.php",
    },
    {
     "type": "user",
     "appid": "wx307e399609946068"
    },
    {
     "type": "text",
     "text": "此處可根據(jù)品牌商需要,用于簡(jiǎn)單描述商品或活動(dòng)。"
    }
   ]
  }
 }
}

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token公眾號(hào)的全局憑據(jù),用于接口調(diào)用。
keystandard商品編碼標(biāo)準(zhǔn)。
keystr商品編碼內(nèi)容。
action_info商品的推廣服務(wù)區(qū)信息。

詳細(xì)參數(shù)說(shuō)明,請(qǐng)參考“創(chuàng)建商品”接口。

返回示例

正確的JSON返回結(jié)果如下:

{
 "errcode": 0,
 "errmsg": "ok",
 "pid": "5g0B4A90aqc"
}

返回參數(shù)說(shuō)明

參數(shù)說(shuō)明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。
pid轉(zhuǎn)譯后的商品id,將直接編入“獲取商品二維碼接口”返回的二維碼內(nèi)容。

清除商品信息

調(diào)用該接口,商戶可以清除創(chuàng)建成功的商品信息。

請(qǐng)求示例

HTTP請(qǐng)求方式:POST
https://api.weixin.qq.com/scan/product/clear?access_token=access_token 
POST數(shù)據(jù)格式:JSON
POST數(shù)據(jù)例子:
{
 "keystandard": "ean13",
 "keystr": "6900873042720"
}

請(qǐng)求示例說(shuō)明

參數(shù)是否必須說(shuō)明
access_token公眾號(hào)的全局憑據(jù),用于接口調(diào)用。
keystandard商品編碼標(biāo)準(zhǔn)。
keystr商品編碼內(nèi)容。

返回示例

正確的JSON返回結(jié)果如下:

{
 "errcode": 0,
 "errmsg": "ok"
}

返回參數(shù)說(shuō)明

參數(shù)說(shuō)明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。

跳轉(zhuǎn)URL參數(shù)說(shuō)明

場(chǎng)景說(shuō)明:

用戶點(diǎn)擊商品推廣服務(wù)區(qū)Link類型的鏈接后,外跳的URL會(huì)帶上wxkeystand、wxkeystr、wxticket、wxextinfo這四個(gè)參數(shù)。通過(guò)檢查wxticket可以確認(rèn)訪問(wèn)用戶的來(lái)源和身份信息,已實(shí)現(xiàn)精準(zhǔn)運(yùn)營(yíng)。

URL示例:http://p.url.cn/wxscandemo/yangbanjian/fangweilanding?91eddae46161ae26a3e6e928f3c07147=scan&wxkeystandard=qrcode&wxkeystr=cosmetics1&wxticket=azlsdGljdXo4Ymow&wxextinfo=123

參數(shù)說(shuō)明

參數(shù)說(shuō)明
wxkeystand商品編碼標(biāo)準(zhǔn)。
wxkeystr商品編碼內(nèi)容。
wxticket標(biāo)識(shí)來(lái)源的憑證參數(shù)??赏ㄟ^(guò)“檢查wxticket參數(shù)接口”換取對(duì)應(yīng)的商品信息和訪問(wèn)用戶信息。特別地,當(dāng)用戶分享鏈接時(shí),為確保安全,微信會(huì)將wxticket參數(shù)清空。
wxextinfo調(diào)用“獲取商品二維碼接口”時(shí)傳入的extinfo,為標(biāo)識(shí)參數(shù)。

檢查wxticket參數(shù)

調(diào)用該接口,可檢查當(dāng)前訪問(wèn)用戶來(lái)源的商品主頁(yè),以及在網(wǎng)頁(yè)前端獲取該用戶的身份信息。為保證場(chǎng)景的正確性,wxticket參數(shù)作為臨時(shí)簽名僅在20分鐘內(nèi)有效,超過(guò)有效時(shí)長(zhǎng)會(huì)檢查失敗。

請(qǐng)求示例

HTTP請(qǐng)求方式:POST
https://api.weixin.qq.com/scan/scanticket/check?access_token=access_token
POST數(shù)據(jù)格式:JSON
POST數(shù)據(jù)例子:
{
 "ticket": " Ym1haDlvNXJqY3Ru1",
}

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token公眾號(hào)的全局憑據(jù),用于接口調(diào)用。
ticket請(qǐng)求URL中帶上的wxticket參數(shù)。

返回示例

正確的JSON返回結(jié)果如下:

{	
 "errcode":0,
 "errmsg":"ok",
 "keystandard":"ean13",
 "keystr":"6901481811083",
 "openid":"otAzGjrS4AYCmeJM1GhEOcHXXTAo",
 "scene":"scan",
 "is_check": false,
 "is_contact": false
}

返回參數(shù)說(shuō)明

參數(shù)說(shuō)明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。
keystandard商品編碼標(biāo)準(zhǔn)。
keystr商品編碼內(nèi)容。
openid當(dāng)前訪問(wèn)者的openid,可唯一標(biāo)識(shí)用戶。
scene打開(kāi)商品主頁(yè)的場(chǎng)景,scan為掃碼,others為其他場(chǎng)景,可能是會(huì)話、收藏或朋友圈。
is_check該條碼(二維碼)是否被掃描,true為是,false為否。
is_contact是否關(guān)注公眾號(hào),true為已關(guān)注,false為未關(guān)注。

組件消息

      調(diào)用該接口,需先在“創(chuàng)建商品”時(shí)設(shè)置組件內(nèi)容,之后可通過(guò)該接口對(duì)組件區(qū)的展示結(jié)果進(jìn)行控制。

      目前,商戶通過(guò)微信推送的“事件”,可獲得被掃碼查詢的商品信息以及商戶之前設(shè)置的“extinfo”內(nèi)容。通過(guò)和本地信息進(jìn)行校驗(yàn),可判斷用戶所查詢的商品真?zhèn)危⒔Y(jié)果通過(guò)該接口返回微信,最終由微信在客戶端定制頁(yè)面上展示真?zhèn)蔚牟樵兘Y(jié)果。

      商戶設(shè)置組件內(nèi)容后,【用戶—微信—商戶】的信息交互模式如下:

推送XML示例

 <xml> 
<ToUserName><![CDATA[gh_fbe8a958756e]]></ToUserName> 
<FromUserName><![CDATA[otAzGjrJVN21mpDF4ZWQiYZwdK0Y]]></FromUserName>
<CreateTime>1447848568</CreateTime> 
<MsgType><![CDATA[event]]></MsgType> 
<Event><![CDATA[scan_product_callback]]></Event> 
<KeyStandard><![CDATA[qrcode]]></KeyStandard> 
<KeyStr><![CDATA[weixin_antifake]]></KeyStr> 
<ExtInfo><![CDATA[hyhy]]></ExtInfo> 
<NeedAntiFake>true</NeedAntiFake> 
</xml>

推送參數(shù)說(shuō)明

參數(shù)說(shuō)明
ToUserName商戶的公眾號(hào)原始id。
FromUserName用戶的openid。
CreateTime消息創(chuàng)建時(shí)間(整型)。
MsgType消息類型,event。
Event事件類型,scan_product_callback為組件消息事件。
KeyStandard商品編碼標(biāo)準(zhǔn)。
KeyStr商品編碼內(nèi)容。
ExtInfo調(diào)用“獲取商品二維碼接口”時(shí)傳入的extinfo,為標(biāo)識(shí)參數(shù)。
NeedAntiFake請(qǐng)是否使用微信提供的彈窗頁(yè)面展示防偽結(jié)果,true為使用,false為未使用。

返回XML示例

 <xml> 
<ToUserName><![CDATA[otAzGjrJVN21mpDF4ZWQiYZwdK0Y]]></ToUserName> 
<FromUserName><![CDATA[gh_fbe8a958756e]]></FromUserName>
<CreateTime>1447848568</CreateTime> 
<MsgType><![CDATA[scanproduct]]></MsgType> 
<ScanProduct> 
<KeyStandard><![CDATA[qrcode]]></KeyStandard> 
<KeyStr><![CDATA[weixin_antifake]]></KeyStr> 
<ExtInfo><![CDATA[hyhy]]></ExtInfo> 
<AntiFake> 
<CodeResult><![CDATA[real]]></CodeResult> 
</AntiFake> 
</ScanProduct>
</xml>

返回參數(shù)說(shuō)明

參數(shù)說(shuō)明
ToUserName用戶的openid。
FromUserName商戶的公眾號(hào)原始id。
CreateTime消息創(chuàng)建時(shí)間(整型)。
MsgType消息類型,scanproduct。
KeyStandard商品編碼標(biāo)準(zhǔn)。
KeyStr商品編碼內(nèi)容。
ExtInfo調(diào)用“獲取商品二維碼接口”時(shí)傳入的extinfo,為標(biāo)識(shí)參數(shù)。
AntiFake防偽信息的內(nèi)容。
CodeResult商品防偽查詢的結(jié)果,real表示碼為真,fake表示碼為假,not_active表示該防偽碼未激活。

清除掃碼記錄

當(dāng)商品主頁(yè)設(shè)置了“原生防偽組件”時(shí)(詳情請(qǐng)查看【創(chuàng)建商品】),用戶每一次掃碼查看主頁(yè),均會(huì)被計(jì)數(shù),進(jìn)而展示在“防偽查詢?cè)斍椤敝小H绻虘粝M硞€(gè)碼的掃碼記錄“歸零”,可調(diào)用該接口,清除該碼的被掃碼記錄。

請(qǐng)求示例

HTTP請(qǐng)求方式:POST
https://api.weixin.qq.com/scan/scanticket/check?access_token=access_token
POST數(shù)據(jù)格式:JSON
POST數(shù)據(jù)例子:
{
 "keystandard": "ean13",
 "keystr": "6900000000000",
 "extinfo":"extinfo"
}

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token公眾號(hào)的全局憑據(jù),用于接口調(diào)用。
keystandard商品編碼標(biāo)準(zhǔn)。
keystr商品編碼內(nèi)容。
extinfo調(diào)用“獲取商品二維碼接口”時(shí)傳入的extinfo,為標(biāo)識(shí)參數(shù)。

返回示例

正確的JSON返回結(jié)果如下:

{	
 "errcode":0,
 "errmsg":"ok"
}

返回參數(shù)說(shuō)明

參數(shù)說(shuō)明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)