W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗(yàn)值獎勵
使用該接口,商戶可獲取賬號下的類目與號段等信息。
請求示例
HTTP請求方式:GET https://api.weixin.qq.com/scan/merchantinfo/get?access_token=TOKEN
請求參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 公眾號的全局憑據(jù),用于接口調(diào)用。 |
返回示例
正確的JSON返回結(jié)果如下:
{ "errcode": 0, "errmsg": "ok", "brand_tag_list":[ "小耿哥8", "testtag" ], "verified_list": [ { "verified_firm_code": 69300570, "verified_cate_list": [ { "verified_cate_id": 538071212, "verified_cate_name": "食品/茶葉/特產(chǎn)/滋補(bǔ)品" } ] }, { "verified_firm_code": 123, "verified_cate_list": [ { "verified_cate_id": 538071212, "verified_cate_name": "食品/茶葉/特產(chǎn)/滋補(bǔ)品" } ] } ] }
返回參數(shù)說明
參數(shù) | 說明 |
---|---|
errcode | 0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。 |
errmsg | ok為調(diào)用成功,否則返回錯(cuò)誤提示。 |
brand_tag_list | 品牌標(biāo)簽列表,創(chuàng)建商品時(shí)傳入,商戶自定義生成的品牌標(biāo)識字段。 |
verified_list | 權(quán)限列表,包含商戶號段、類目ID、類目名稱三者的對應(yīng)關(guān)系。 |
verified_firm_code | 商戶號段,表示該商戶下有資質(zhì)的條碼號段。 |
verified_cate_list | 商戶類目列表,包含類目ID與對應(yīng)的類目名稱。 |
verified_cate_id | 商戶類目ID,表示該商戶下可用于創(chuàng)建商的類目ID |
verified_cate_name | 商戶類目名稱,對應(yīng)類目ID的名稱 |
注意:商戶容易忽略verified_cate_id,導(dǎo)致下一步商品創(chuàng)建失敗。
使用該接口,商戶可以創(chuàng)建商品信息,設(shè)置商品主頁,支持條碼和二維碼兩種類型。目前,一個(gè)賬號最多支持創(chuàng)建10萬條商品信息。
請求示例
HTTP請求方式:POSThttps://api.weixin.qq.com/scan/product/create?access_token=tT8VqJWVX4C-WvIG41tyelMclMZsAPFbLxbECsJvIghceqQCMB83hI5bxcInUR-amUrVsKq4bcBmF9PgooNrFA POST數(shù)據(jù)格式:JSON POST數(shù)據(jù)例子: { "keystandard": "ean13", "keystr": "6900000000000", "brand_info":{ "base_info":{ "title": "掃一掃動態(tài)主頁demo", "thumb_url":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNrX6Yrvd7LzKERyic3kn3VdSsmFr5F5ibXzj9Al65yWFudmjqcWic1Qe9g/0", "brand_tag": "小耿哥8", "category_id": 0, "store_mgr_type": "auto", "store_vendorid_list":[], "color": "auto", }, "detail_info":{ "banner_list":[ {"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNic0LvlkCw7s6mZpicib7ict5MhoiaL3gPrYXpibnibOpViaYJFpic12nx4bNZcQ/0", "desc": "微信相框"}, {"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNbTfwJmlVXp9k1A80UCFL1a9icwdthmSLh0RuJ5iaKcZBwdXbOicktkwPQ/0", "desc": "微信相框"}, {"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNW4FD74oXjEyqHicE9U3H0nTCdLHibo7rRia2TFBQ6tx2Pvic92ica8Wns4Q/0", "desc": "微信相框"} ], "detail_list":[ { "title": "產(chǎn)品名稱", "desc": "微信相框moment" }, { "title": "設(shè)計(jì)團(tuán)隊(duì)", "desc": "微信團(tuán)隊(duì)" }, { "title": "設(shè)計(jì)初衷", "desc": "做一個(gè)簡單純粹的電子相框" }, { "title": "產(chǎn)品訴求", "desc": "以相框?yàn)榧~帶,增加子女與父母長輩的溝通,用照片通過微信傳遞感情交流" } ] }, "action_info":{ "action_list":[ { "type": "price", "retail_price":"12.00" }, { "type": "link", "name": "banner", "link": "http://mp.weixin.qq.com", "image":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNgjXTKn0j4TlfXjUOPYBDicVOmG0sdNfUOg9Lzia2g9cbjyTXmOiaB6L1g/0", "showtype": "banner" }, { "type": "link", "name": "自定義活動1", "link": "http://p.url.cn/wxscan.php", }, { "type": "link", "name": "自定義活動2", "link": "http://p.url.cn/wxscan.php", }, { "type": "user" }, { "type": "text", "text": "此處可根據(jù)品牌商需要,用于簡單描述商品或活動。" } ] }, "module_info":{ "module_list":[ { "type": "anti_fake", "native_show": "fales", "anti_fake_url": "weixin.qq.com" } ] } } }
請求參數(shù)說明
POST的主要結(jié)構(gòu)為brand_info,包含商品基本信息base_info、商品詳情信息detail_info、推廣服務(wù)信息action_info和組件信息module_info四部分。
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 公眾號的全局憑據(jù),用于接口調(diào)用。 |
keystandard | 是 | 商品編碼標(biāo)準(zhǔn),支持ean13、ean8和qrcode標(biāo)準(zhǔn)。 |
keystr | 是 | 商品編碼內(nèi)容。直接填寫商品條碼, 標(biāo)準(zhǔn)是ean13,則直接填寫商品條碼,如“6901939621608”。 標(biāo)準(zhǔn)是qrcode,二維碼的內(nèi)容可由商戶自定義,建議使用商品條碼,≤20個(gè)字符,由大小字母、數(shù)字、下劃線和連字符組成。 注意:編碼標(biāo)準(zhǔn)是ean13時(shí),編碼內(nèi)容必須在商戶的號段之下,否則會報(bào)錯(cuò)。 |
base_info | 是 | 商品的基本信息。 |
detail_info | 是 | 商品的詳細(xì)描述信息。 |
action_info | 是 | 商品的推廣服務(wù)區(qū)信息。 |
module_info | 否 | 商品的組件信息。 |
base_info部分
參數(shù) | 是否必須 | 說明 |
---|---|---|
title | 是 | 商品名稱,建議不超過15個(gè)字,超過部分在客戶端上以省略號顯示。 |
thumb_url | 是 | 商品縮略圖,推薦尺寸為180px*180px,大小不超過50k,支持jpg、png、gif、jpeg格式。 |
brand_tag | 是 | 品牌字段,如“寶潔海飛絲”、“寶潔飄柔”。 |
category_id | 是 | 商品類目ID,通過“獲取商戶信息”接口獲取。 |
store_mgr_type | 否 | 是否展示有該商品的電商渠道,識別條件是編碼內(nèi)容。auto為自動,由微信識別展示渠道;custom為自定義,商戶可指定store_vendorid_list內(nèi)的渠道出現(xiàn)。 |
store_vendorid_list | 否 | 電商渠道,如果store_mgr_type為custom,則可從以下電商渠道進(jìn)行選擇:2為亞馬遜,3為當(dāng)當(dāng)網(wǎng),4為京東,9為一號店,11為聚美優(yōu)品,19為酒仙網(wǎng) |
color | 否 | 主頁頭部背景色。設(shè)置“auto”或不填則自動取色;也支持傳入十六進(jìn)制顏色碼自定義背景色。比如,“FFFFFF”代表純白色。注意:顏色碼不識別大小寫,也不需要傳入“#” |
detail_info部分
參數(shù) | 是否必須 | 說明 |
---|---|---|
banner_list | 是 | 商品詳情頁中圖文詳情可設(shè)置多張圖片。 |
link | 是 | 商品詳情頁中圖文詳情的圖片,640px*320px,單張≤200k,支持jpg、png、gif、jpeg格式,最多可上傳6張。 |
desc | 否 | 商品詳情頁中圖文詳情的描述,≤80個(gè)漢字。 |
detail_list | 是 | 商品詳情頁中可設(shè)置多組商品屬性。 |
title | 是 | 商品詳情頁中商品屬性名稱,≤6個(gè)漢字。 |
desc | 否 | 商品詳情頁中商品屬性內(nèi)容,≤80個(gè)漢字。 |
action_info部分
參數(shù) | 是否必須 | 說明 |
---|---|---|
action_list | 是 | 商品主頁中可設(shè)置多個(gè)服務(wù)欄。 |
type | 是 | 服務(wù)欄的類型,Media,視頻播放;Text,文字介紹;Link,圖片跳轉(zhuǎn);Link,普通鏈接;User,公眾號;Card,微信卡券;Price,建議零售價(jià);Product,微信小店;Store,電商鏈接;recommend,商品推薦。 |
類型:視頻播放
參數(shù) | 是否必須 | 說明 |
---|---|---|
type | 是 | 服務(wù)欄類型,視頻類型的參數(shù)值為"media"。 |
link | 是 | 對應(yīng)的視頻鏈接,僅支持在v.qq.com上傳的視頻內(nèi)容,格式請按JSON示例拼接。 |
image | 是 | 對應(yīng)視頻的封面,推薦尺寸690px*320px,大小不超過200k,支持jpg、png、gif、jpeg格式。 |
類型:文字介紹
參數(shù) | 是否必須 | 示例值 | 說明 |
---|---|---|---|
type | 是 | text | 服務(wù)欄類型。 |
name | 否 | 商品介紹 | 對應(yīng)文字介紹的標(biāo)題。 |
text | 是 | 此處可根據(jù)品牌商需要,用于簡單描述商品或活動。 | 對應(yīng)文字介紹的內(nèi)容。 |
類型:圖片跳轉(zhuǎn)
參數(shù) | 是否必須 | 說明 |
---|---|---|
type | 是 | 服務(wù)欄類型,圖片跳轉(zhuǎn)類型的參數(shù)值為"link"。 |
link | 是 | 對應(yīng)圖片跳轉(zhuǎn)后的網(wǎng)頁鏈接。 |
image | 是 | 對應(yīng)跳轉(zhuǎn)入口的圖片鏈接,請參考JSON示例。 |
showtype | 是 | 值為banner,設(shè)置圖片跳轉(zhuǎn)類型的服務(wù)欄時(shí)必填。 |
類型:普通鏈接
參數(shù) | 是否必須 | 示例值 | 說明 |
---|---|---|---|
type | 是 | link | 服務(wù)欄類型。 |
name | 是 | 查看官網(wǎng) | 鏈接入口的名稱,不超過12個(gè)漢字。 |
link | 是 | http://www.qq.com | 對應(yīng)跳轉(zhuǎn)后的網(wǎng)頁鏈接。 |
digest | 否 | 點(diǎn)擊查看 | 服務(wù)欄右側(cè)的引導(dǎo)語,不超過5個(gè)漢字。 |
類型:公眾號
參數(shù) | 是否必須 | 示例值 | 說明 |
---|---|---|---|
type | 是 | user | 服務(wù)欄類型。 |
類型:微信卡券
參數(shù) | 是否必須 | 示例值 | 說明 |
---|---|---|---|
type | 是 | card | 服務(wù)欄類型。 |
cardid | 是 | pbLatjlZyVY2XCKfIDULuD_J_PKI | 卡券必須為非自定義code(概念說明見微信卡券接口文檔)。 |
digest | 否 | 全場通用 | 服務(wù)欄右側(cè)的引導(dǎo)語,不超過5個(gè)漢字。 |
類型:建議零售價(jià)
參數(shù) | 是否必須 | 示例值 | 說明 |
---|---|---|---|
type | 是 | price | 服務(wù)欄類型。 |
retail_price | 是 | 12.00 | 表示商品的建議零售價(jià),以“元”為單位。 |
類型:微信小店
參數(shù) | 是否必須 | 示例值 | 說明 |
---|---|---|---|
type | 是 | product | 服務(wù)欄類型。 |
name | 是 | 官網(wǎng)商城 | 微信小店入口的名稱。 |
productid | 是 | pLHCTjvXB6vIqUYUn51AWsK-sKA8 | 對應(yīng)小店商品的id,需保證有效。 |
digest | 否 | 限時(shí)折扣 | 服務(wù)欄右側(cè)的引導(dǎo)語,不超過5個(gè)漢字。 |
類型:電商鏈接
參數(shù) | 是否必須 | 示例值 | 說明 |
---|---|---|---|
type | 是 | store | 服務(wù)欄類型。 |
name | 是 | 京東商城 | 電商入口的名稱。 |
link | 是 | http://m.jd.com/product/14091549.html | 對應(yīng)電商的鏈接,建議是可以直接購買該商品的頁面。 |
sale_price | 是 | 12.50 | 對應(yīng)商品的價(jià)格,單位元。 |
類型:商品推薦
參數(shù) | 是否必須 | 說明 |
---|---|---|
type | 是 | 服務(wù)欄類型,商品推薦的值為recommende。 |
recommend_type | 是 | 表示商品推薦的方式,目前只支持指定,值為appointed。 |
recommend_list | 是 | 表示指定要推薦的商品列表 |
keystandard | 是 | 表示被推薦的商品編碼格式。 |
keystr | 是 | 表示被推薦商品的編碼內(nèi)容。 |
“商品推薦”的JSON示例:
{ "type": "recommend", "recommend": { "recommend_type": "appointed", "recommend_list": [ { "keystandard": "ean13", "keystr": "6900000000001" }, { "keystandard": "ean13", "keystr": "6900873042720" } ] } }
module_info部分
參數(shù) | 是否必須 | 說明 |
---|---|---|
module_list | 否 | 未來可設(shè)置多個(gè)組件,目前僅支持防偽組件。 |
type | 否 | 組件的類型,目前僅包括防偽組件anti_fake。 |
native_show | 否 | 設(shè)置為true時(shí),防偽結(jié)果使用微信提供的彈窗頁面展示,商戶僅需調(diào)用“商品管理”部分的組件消息接口回傳產(chǎn)品真假信息。設(shè)置為false時(shí),無防偽彈窗效果。 |
anti_fake_url | 否 | 商戶提供的防偽查詢鏈接,當(dāng)native_show設(shè)置為false時(shí)必填。 |
注意:
1、推廣服務(wù)區(qū)action_info部分,入口數(shù)量規(guī)則如下:
1)至少設(shè)置一個(gè)推廣類型;
2)文字介紹、公眾號和微信卡券三種推廣類型,每種類型最多只能分別設(shè)置1個(gè);
3)普通鏈接、公眾號、微信卡券三種類型合計(jì)最多設(shè)置3個(gè);
4)圖片跳轉(zhuǎn)鏈接和視頻播放只能二選一展示;
2、商品主頁中必須存在至少一個(gè)價(jià)格信息,價(jià)格的展示渠道有四種:
1)在base_info中定義store_mgr_type和store_vendorid_list字段。如果商品在設(shè)置的電商渠道有銷售,則會有售賣入口在【購買區(qū)】展示。例如:“洋河-天之藍(lán) 480ml”在“京東商城”有銷售,假設(shè)京東商城又在該商品設(shè)置的電商渠道列表中,則會有“京東商城”的售賣入口出現(xiàn)。
2)在微信小店(Product)類型中設(shè)置productid,購買區(qū)將出現(xiàn)對應(yīng)商品的微信小店售賣入口。
3)在電商鏈接(Store)類型中設(shè)置目標(biāo)地址鏈接(link),購買區(qū)將出現(xiàn)所配置的外部商城售賣入口。
4)在建議零售價(jià)(Price)類型中設(shè)置retail_price字段。如果商品沒有設(shè)置前文所述的任何一種購買渠道,也會有該商品建議零售價(jià)展示。
返回示例
正確的JSON返回結(jié)果如下:
{ "errcode": 0, "errmsg": "ok", "pid": "5g0B4A90aqc" }
返回參數(shù)說明
參數(shù) | 說明 |
---|---|
errcode | 0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。 |
errmsg | ok為調(diào)用成功,否則返回錯(cuò)誤提示。 |
pid | 轉(zhuǎn)譯后的商品id,將直接編入“獲取商品二維碼接口”返回的二維碼內(nèi)容。 |
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: