# Commodity interface
| Interface Name | Introductions |
|---|---|
| Get a list of affiliate product categories and category ID | Support developers to get the first class list of alliance products and class ID through the interface |
| Search Full Product | Support developers through access to the full amount of product information alliance (a single maximum of 50 products), support based on product keywords (name, store, spuID), product price, product commission, commission ratio, whether there is a coupon screening |
| Search Alliance Selected Products | Support developers to get the information of the selected products of the alliance (up to 50 products at a time), support according to the product price, product commission, commission ratio, whether there is a Union coupon screening |
| Get product promotion material | Through the interface to obtain product promotion materials, including shop appID, product details page Path, promotion copy and promotion of short chain, product pictures, etc. |
# 1. Get a list of alliance product categories and category ID
# Interface Dxplaination
Through the interface to obtain a list of the first class of alliance goods and class ID, can be used to filter alliance goods
# Request address
GET https://api.weixin.qq.com/union/promoter/product/category?access_token=ACCESS_TOKEN
# Request parameters
| attribute | type | Default values | Required | Introductions |
|---|---|---|---|---|
| access_token | string | yes | Interface calling credential |
# Return value
# Object
Returned JSON Data packet
| attribute | type | Introductions |
|---|---|---|
| Errcode | number | Error code |
| errmsg | string | Error message |
| productCats | Array.<Object> | Category data |
productCats Structure
| attribute | type | Introductions |
|---|---|---|
| catId | string | Category ID |
| name | string | Category Name |
# Return Example
{
"errcode": 0,
"productCats": [
{
"catId": "1234",
"name": "Home textile"
},
{
"catId": "1235",
"name": "Furniture."
},
{
"catId": "1236",
"name": "Mother and child"
},
]
}
# 2. Search for Total Quantity of Goods
# Interface Dxplaination
Support developers to obtain a list and details of products that can be promoted according to a variety of filters, Screening conditions include product keywords (name, store, spuID), product cumulative sales, product price, product commission, commission ratio, whether there is alliance coupon, distribution method, delivery area, etc.
# Request address
GET https://api.weixin.qq.com/union/promoter/product/list?access_token=ACCESS_TOKEN
# Request parameters
| attribute | type | Default values | Required | Introductions |
|---|---|---|---|---|
| access_token | string | yes | Interface calling credential | |
| from | string | yes | Offset from zero | |
| limit | string | yes | Number of posts per page | |
| query | string | no | Search keywords, specific meaning andqueryTypeRelevant | |
| queryType | number | 0 | no | Search Type |
| maxPrice | number | no | Maximum Price of Product in Units | |
| minPrice | number | 0 | no | Minimum price of goods per unit |
| minCommissionValue | number | 0 | no | Minimum Commission Amount, Unit Points |
| minCommissionRatio | number | 0 | no | The lower limit of the commission ratio, the unit is 1 / 10000 |
| sortType | number | 0 | no | |
| categoryId | number | no | A single category ID, value fromGet the class list interface | |
| shopAppIds | Array.<string> | no | Mini StoresAppIDlist | |
| hasCoupon | number | 0 | no | Whether there is a union coupon, 1 for coupons, 0 for all goods |
| category | string | no | Multiple category IDs separated by commas. If it exists with category id, take category id | |
| noCategory | string | no | Blacklist Category ID, do not pull out the blacklist category goods, separated by English comma | |
| productId | string | no | Product SPUID, separated by English commas | |
| shippingMethods | string | no | Delivery method, JSON object string, specific structure seeshippingMethods Structure | |
| addressList | string | no | Shipping address list, JSON array string, single structure seeaddress |
queryType Enumeration of
| value | type | Introductions |
|---|---|---|
| 0 | number | Search Product Name |
| 1 | number | Search Small Shop Name |
| 2 | number | Search for products SPU ID |
sortType Enumeration of
| value | type | Introductions |
|---|---|---|
| 0 | number | Default ordering |
| 1 | number | Product price ascending |
| 2 | number | Descending order of product prices |
| 3 | number | Ascending Commission Percentage |
| 4 | number | Descending Commission Proportion |
| 5 | number | Ascending Commission Value |
| 6 | number | Descending of commission value |
| 7 | number | Sales figures ascending |
| 8 | number | Descending Sales Value |
shippingMethods Structure
| attribute | type | Introductions |
|---|---|---|
| express | number | Express support, 1: yes, 0: no |
| sameCity | number | Does it support city delivery? 1: Yes, 0: No |
| pickup | number | Do you support home delivery? 1: Yes, 0: No |
address Structure
| attribute | type | Introductions |
|---|---|---|
| addressInfo | Object | Address information |
| addressType | Object | Address type, structure same shippingMethods |
addressInfo Structure
| attribute | type | Introductions |
|---|---|---|
| provinceName | string | GB receiving address first level address |
| cityName | string | GB receiving address secondary address |
| countyName | string | GB Receiving Address Third-level Address |
# Return value
| attribute | type | Introductions |
|---|---|---|
| Errcode | number | Error code |
| errmsg | string | Error message |
| total | number | Total number of commodities |
| productList | Array.<Object> | Product list data |
productList Structure
| attribute | type | Introductions |
|---|---|---|
| productId | string | Product SPU ID |
| product | Object | Product data |
| leagueExInfo | Object | Union commission related data |
| shopInfo | Object | Mini Store data |
| couponInfo | Object | Alliance Coupon Data |
product Structure
| attribute | type | Introductions |
|---|---|---|
| productId | string | Product SPU ID |
| info | Object | Product specific information |
| info.title | string | Product Title |
| info.subTitle | string | Product Subtitle |
| info.headImg | Array.<string> | Product master chart |
| info.category | Array.<string> | Product category |
| info.category[].catId | Object | Category ID |
| info.category[].name | Object | Category Name |
| info.brand | string | Brand name |
| info.brandId | string | Brand ID |
| info.model | string | model |
| info.detail | Object | Detailed Product Data |
| info.detail.detailImg | Array.<string> | Picture of the day |
| info.param | Array.<Object> | Commodity parameter |
| info.minPrice | number | Minimum price of goods per unit |
| info.totalStockNum | number | Total inventory |
| info.totalSoldNum | number | Cumulative sales |
| info.totalOrderNum | number | Cumulative order volume |
| skus | Array.<Object> | Products SKU |
| skus[].skuId | string | Products SKU ID |
| skus[].productSkuInfo.thumbImg | string | Products SKU Small map |
| skus[].productSkuInfo.salePrice | Object | Products SKU Sales Price, Unit Points |
| skus[].productSkuInfo.marketPrice | Object | Products SKU Market price, unit cent |
| skus[].productSkuInfo.stockInfo.stockNum | number | Products SKU stock |
leagueExInfo Structure
| attribute | type | Introductions |
|---|---|---|
| hasCommission | number | Is there a commission? 1/0 |
| commissionRatio | number | Commission ratio, 1 / 10,000 |
| commissionValue | number | Commission amount per unit |
shopInfo Structure
| attribute | type | Introductions |
|---|---|---|
| name | string | Small Shop Name |
| appId | string | Mini StoresAppID |
| username | string | Mini Store original id |
| headImgUrl | string | Mini Store head |
| shippingMethods | Object | For distribution, seeshippingMethods Structure |
| addressList | Array.<address> | Place of shipment, only if the mode of delivery includesDelivery in the same city, from the doorOnly then this item |
| sameCityTemplate | Object | Scope of distribution only if the mode of distribution includesSame city distributionOnly then this item |
| freightTemplate | Object | Shipping templates only if the shipping method containsexpress deliveryThis is the only time |
couponInfo Structure
| attribute | type | Introductions |
|---|---|---|
| hasCoupon | number | Whether there is a union coupon, 1 for coupons, 0 for all goods |
| couponId | string | Ticket id |
| couponDetail | Object | Voucher Details |
couponDetail Structure
| attribute | type | Introductions |
|---|---|---|
| restNum | number | Coupon stock |
| type | number | Coupon Type |
| discountInfo | Object | Coupon denomination |
| validInfo | Object | period of validity |
| receiveInfo | Object | Coupon Collection Time |
discountInfo Structure
| attribute | type | Introductions |
|---|---|---|
| discountCondition.productIds[] | string | Designated goods id |
| discountCondition.productCnt | number | Number of goods |
| discountCondition.productPrice | number | Amount of merchandise |
| discountNum | number | Number of discounts, such as 5.1 fold for 5.1 * 1000 |
| discountFee | number | Amount reduced in points |
validInfo Structure
| attribute | type | Introductions |
|---|---|---|
| validType | number | Type of expiry, 1 Specify a time interval for the product, 2 Number of effective days |
| validDayNum | number | Days of entry into force |
| startTime | string | Effective Start Time |
| endTime | string | Effective end time |
receiveInfo Structure
| attribute | type | Introductions |
|---|---|---|
| startTime | string | Start Time Stamp |
| endTime | string | Receive end time stamp |
| limitNumOnePerson | number | Limited number of tickets per person |
sameCityTemplate Structure
| attribute | type | Introductions |
|---|---|---|
| deliverScopeType | number | Distribution scope definition, 0: according to the distance to define the distribution scope, 1: in accordance with the regional definition distribution scope |
| scope | string | Distribution scope |
| region | Object | Distribution scope and structure of city-wide distributionaddressInfo |
freightTemplate Structure
| attribute | type | Introductions |
|---|---|---|
| notSendArea | Object | Non Shipping Area |
notSendArea Structure
| attribute | type | Introductions |
|---|---|---|
| addressInfoList | Array.<addressInfo> | List of non-shipping addresses |
# Return Example
{
"errcode": 0,
"errmsg": "",
"productList": [
{
"productId": "7554942",
"product": {
"productId": "7554942",
"status": 5,
"info": {
"title": " Add merchandise and save case_UpProduct",
"subTitle": "This is the product subtitle,"
"headImg": [
"https://wxamusic.wx.qq.with/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&appid=wx678687fa5226e237"
],
"category": [
{
"catId": "1247",
"name": "Furniture,"
"fCatId": "0",
"updateTime": "0",
"catType": 1,
"bizuin": "3845180796",
"brandCat": "9223372036854775807",
"catInfo": {
"isRequired": 0,
"isCustomize": 0,
"catLevel": 1
},
"auditId": "0",
"desc": "",
"priority": 0
},
{
"catId": "1267",
"name": "Children's furniture,"
"fCatId": "1247",
"catType": 1,
"version": 0,
"bizuin": "0",
"catInfo": {
"isRequired": 0,
"isCustomize": 0,
"catLevel": 2
},
"auditId": "0",
"desc": "",
"priority": 0
},
{
"catId": "1270",
"name": "Crib for children,"
"fCatId": "1267",
"createTime": "0",
"updateTime": "0",
"catType": 1,
"version": 0,
"bizuin": "0",
"brandCat": "9223372036854775807",
"catInfo": {
"isRequired": 0,
"isCustomize": 0,
"specType": 0,
"specTypeDesc": "",
"attrTemplateId": "0",
"attrTemplateName": "",
"maxAttrNum": 18,
"editByUser": 0,
"catLevel": 3,
"highestPriceFixing": 0,
"wording": "",
"description": "",
"maxProductNum": 0,
"qualification": "",
"productQualification": "",
"quaNeedAudit": "",
"maxQualificationImg": 0,
"catGroup": 0,
"individualAuditInfo": {
"qualification": "",
"productQualification": "",
"quaNeedAudit": "",
"maxQualificationImg": 0
},
"enterpriseAuditInfo": {
"qualification": "",
"productQualification": "",
"quaNeedAudit": "",
"maxQualificationImg": 0
}
},
"auditId": "0",
"desc": "",
"priority": 0
}
],
"brand": "",
"brandId": "2100000000",
"model": "",
"detail": {
"detailImg": [
"https://wxamusic.wx.qq.with/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&appid=wx678687fa5226e237"
],
"detailVideos": [],
"detailVideoInfo": []
},
"param": [],
"minPrice": 2000,
"expressInfo": {
"templateId": "37927"
},
"totalStockNum": 0
},
"skus": []
},
"leagueExInfo": {
"hasCommission": 1,
"commissionRatio": 8000,
"commissionValue": 1600
},
"shopInfo": {
"name": "Pork belly shop,"
"guaranteeFlag": 0,
"headImgUrl": " http://wx.qlogo.cn/mmhead/Q3auHgzwzM77ia7ibuPAQBJgME8gFF9APicaSpd7evrLCVb5hn2zsUBOw"
}
},
{
"productId": "6565746",
"product": {
"productId": "6565746",
"status": 5,
"info": {
"title": "Testing wigs."
"subTitle": "Testing wigs."
"headImg": [
"https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/5fd316dc0000ef4b0000000043785609000000a000004f50"
],
"category": [
{
"catId": "1001",
"name": ""
},
{
"catId": "1030",
"name": ""
},
{
"catId": "1031",
"name": ""
}
],
"brandId": "2100000000",
"detail": {
"detailImg": [],
"detailVideos": [],
"detailVideoInfo": [],
"desc": "Test Goods"
},
"param": [],
"minPrice": 100,
"expressInfo": {
"templateId": "1024691"
},
"totalStockNum": 39995
},
"skus": [
{
"skuId": "11913889",
"status": 5,
"productSkuInfo": {
"saleParam": [
{
"categorys": [
{
"catId": "35245",
"name": "Choose products,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000000",
"name": "111",
"fCatId": "35245",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 1
}
]
},
{
"categorys": [
{
"catId": "35246",
"name": "Choose a color,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000001",
"name": "3333",
"fCatId": "35246",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 1
}
]
}
],
"thumbImg": "",
"skuCode": "",
"salePrice": 100,
"marketPrice": 100,
"stockInfo": {
"stockNum": 20000
},
"appidForMedia": ""
}
},
{
"skuId": "11915862",
"status": 5,
"productSkuInfo": {
"saleParam": [
{
"categorys": [
{
"catId": "35245",
"name": "Choose products,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000002",
"name": "1112",
"fCatId": "35245",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 2
}
]
},
{
"categorys": [
{
"catId": "35246",
"name": "Choose a color,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000001",
"name": "3333",
"fCatId": "35246",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 1
}
]
}
],
"thumbImg": "",
"skuCode": "",
"salePrice": 100,
"marketPrice": 100,
"stockInfo": {
"stockNum": 20000
},
"appidForMedia": ""
}
}
]
},
"leagueExInfo": {
"hasCommission": 1,
"commissionRatio": 3300,
"commissionValue": 33
},
"shopInfo": {
"name": "Yuan yuan small cute,"
"guaranteeFlag": 0,
"headImgUrl": " http://wx.qlogo.cn/mmhead/574VdhMFwaETvsGUwOpJsHAWaM3UDznibq3MMMiaOPSt7Ir1ecTLOfJQ/0"
}
}
],
"total": 100
}
# 3. Search Alliance Select Products
# Interface Dxplaination
Support developers to obtain the list and details of selected products according to a variety of screening conditions, including product prices, product commissions, cumulative sales volume of goods, commission ratio, whether there is alliance coupons, distribution method, delivery area
# Request address
GET https://api.weixin.qq.com/union/promoter/product/select?access_token=ACCESS_TOKEN
# Request parameters
| attribute | type | Default values | Required | Introductions |
|---|---|---|---|---|
| access_token | string | yes | Interface calling credential | |
| from | string | yes | Offset from zero | |
| limit | string | yes | Number of posts per page | |
| maxPrice | number | no | Maximum Price of Product in Units | |
| minPrice | number | 0 | no | Minimum price of goods per unit |
| minCommissionValue | number | 0 | no | Minimum Commission Amount, Unit Points |
| minCommissionRatio | number | 0 | no | The lower limit of the commission ratio, the unit is 1 / 10000 |
| sortType | number | 0 | no | |
| categoryId | number | no | A single category ID, value fromGet the class list interface | |
| shopAppIds | Array.<string> | no | Mini StoresAppIDlist | |
| hasCoupon | number | 0 | no | Whether there is a union coupon, 1 for coupons, 0 for all goods |
| category | string | no | Multiple category IDs separated by commas. If it exists with category id, take category id | |
| noCategory | string | no | Blacklist Category ID, do not pull out the blacklist category goods, separated by English comma | |
| productId | string | no | Product SPUID, separated by English commas | |
| shippingMethods | string | no | Delivery method, JSON object string, specific structure seeshippingMethods Structure | |
| addressList | string | no | Shipping address list, JSON array string, single structure seeaddress |
sortType Enumeration of
| value | type | Introductions |
|---|---|---|
| 0 | number | Default ordering |
| 1 | number | Product price ascending |
| 2 | number | Descending order of product prices |
| 3 | number | Ascending Commission Percentage |
| 4 | number | Descending Commission Proportion |
| 5 | number | Ascending Commission Value |
| 6 | number | Descending of commission value |
| 7 | number | Sales figures ascending |
| 8 | number | Descending Sales Value |
shippingMethods Structure
| attribute | type | Introductions |
|---|---|---|
| express | number | Express support, 1: yes, 0: no |
| sameCity | number | Does it support city delivery? 1: Yes, 0: No |
| pickup | number | Do you support home delivery? 1: Yes, 0: No |
address Structure
| attribute | type | Introductions |
|---|---|---|
| addressInfo | Object | Address information |
| addressType | Object | Address type, structure same shippingMethods |
addressInfo Structure
| attribute | type | Introductions |
|---|---|---|
| provinceName | string | GB receiving address first level address |
| cityName | string | GB receiving address secondary address |
| countyName | string | GB Receiving Address Third-level Address |
# Return value
| attribute | type | Introductions |
|---|---|---|
| Errcode | number | Error code |
| errmsg | string | Error message |
| total | number | Total number of commodities |
| productList | Array.<Object> | Product list data |
productList Structure
| attribute | type | Introductions |
|---|---|---|
| productId | string | Product SPU ID |
| product | Object | Product data |
| leagueExInfo | Object | Union commission related data |
| shopInfo | Object | Mini Store data |
| couponInfo | Object | Alliance Coupon Data |
product Structure
| attribute | type | Introductions |
|---|---|---|
| productId | string | Product SPU ID |
| info | Object | Product specific information |
| info.title | string | Product Title |
| info.subTitle | string | Product Subtitle |
| info.headImg | Array.<string> | Product master chart |
| info.category | Array.<string> | Product category |
| info.category[].catId | Object | Category ID |
| info.category[].name | Object | Category Name |
| info.brand | string | Brand name |
| info.brandId | string | Brand ID |
| info.model | string | model |
| info.detail | Object | Detailed Product Data |
| info.detail.detailImg | Array.<string> | Picture of the day |
| info.param | Array.<Object> | Commodity parameter |
| info.minPrice | number | Minimum price of goods per unit |
| info.totalStockNum | number | Total inventory |
| info.totalSoldNum | number | Cumulative sales |
| info.totalOrderNum | number | Cumulative order volume |
| skus | Array.<Object> | Products SKU |
| skus[].skuId | string | Products SKU ID |
| skus[].productSkuInfo.thumbImg | string | Products SKU Small map |
| skus[].productSkuInfo.salePrice | Object | Products SKU Sales Price, Unit Points |
| skus[].productSkuInfo.marketPrice | Object | Products SKU Market price, unit cent |
| skus[].productSkuInfo.stockInfo.stockNum | number | Products SKU stock |
leagueExInfo Structure
| attribute | type | Introductions |
|---|---|---|
| hasCommission | number | Is there a commission? 1/0 |
| commissionRatio | number | Commission ratio, 1 / 10,000 |
| commissionValue | number | Commission amount per unit |
shopInfo Structure
| attribute | type | Introductions |
|---|---|---|
| name | number | Small Shop Name |
| appId | string | Mini StoresAppID |
| username | string | Mini Store original id |
| headImgUrl | string | Mini Store head |
| shippingMethods | Object | For distribution, seeshippingMethods Structure |
| addressList | Array.<address> | Place of shipment, only if the mode of delivery includesDelivery in the same city, from the doorOnly then this item |
| sameCityTemplate | Object | Scope of distribution only if the mode of distribution includesSame city distributionOnly then this item |
| freightTemplate | Object | Shipping templates only if the shipping method containsexpress deliveryThis is the only time |
couponInfo Structure
| attribute | type | Introductions |
|---|---|---|
| hasCoupon | number | Whether there is a union coupon, 1 for coupons, 0 for all goods |
| couponId | string | Ticket id |
| couponDetail | Object | Voucher Details |
couponDetail Structure
| attribute | type | Introductions |
|---|---|---|
| restNum | number | Coupon stock |
| type | number | Coupon Type |
| discountInfo | Object | Coupon denomination |
| validInfo | Object | period of validity |
| receiveInfo | Object | Coupon Collection Time |
discountInfo Structure
| attribute | type | Introductions |
|---|---|---|
| discountCondition.productIds[] | string | Designated goods id |
| discountCondition.productCnt | number | Number of goods |
| discountCondition.productPrice | number | Amount of merchandise |
| discountNum | number | Number of discounts, such as 5.1 fold for 5.1 * 1000 |
| discountFee | number | Amount reduced in points |
validInfo Structure
| attribute | type | Introductions |
|---|---|---|
| validType | number | Type of expiry, 1 Specify a time interval for the product, 2 Number of effective days |
| validDayNum | number | Days of entry into force |
| startTime | string | Effective Start Time |
| endTime | string | Effective end time |
receiveInfo Structure
| attribute | type | Introductions |
|---|---|---|
| startTime | string | Start Time Stamp |
| endTime | string | Receive end time stamp |
| limitNumOnePerson | number | Limited number of tickets per person |
sameCityTemplate Structure
| attribute | type | Introductions |
|---|---|---|
| deliverScopeType | number | Distribution scope definition, 0: according to the distance to define the distribution scope, 1: in accordance with the regional definition distribution scope |
| scope | string | Distribution scope |
| region | Object | Distribution scope and structure of city-wide distributionaddressInfo |
freightTemplate Structure
| attribute | type | Introductions |
|---|---|---|
| notSendArea | Object | Non Shipping Area |
notSendArea Structure
| attribute | type | Introductions |
|---|---|---|
| addressInfoList | Array.<addressInfo> | List of non-shipping addresses |
# Return Example
{
"errcode": 0,
"errmsg": "",
"productList": [
{
"productId": "7554942",
"product": {
"productId": "7554942",
"status": 5,
"info": {
"title": " Add merchandise and save case_UpProduct",
"subTitle": "This is the product subtitle,"
"headImg": [
"https://wxamusic.wx.qq.with/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&appid=wx678687fa5226e237"
],
"category": [
{
"catId": "1247",
"name": "Furniture,"
"fCatId": "0",
"updateTime": "0",
"catType": 1,
"bizuin": "3845180796",
"brandCat": "9223372036854775807",
"catInfo": {
"isRequired": 0,
"isCustomize": 0,
"catLevel": 1
},
"auditId": "0",
"desc": "",
"priority": 0
},
{
"catId": "1267",
"name": "Children's furniture,"
"fCatId": "1247",
"catType": 1,
"version": 0,
"bizuin": "0",
"catInfo": {
"isRequired": 0,
"isCustomize": 0,
"catLevel": 2
},
"auditId": "0",
"desc": "",
"priority": 0
},
{
"catId": "1270",
"name": "Crib for children,"
"fCatId": "1267",
"createTime": "0",
"updateTime": "0",
"catType": 1,
"version": 0,
"bizuin": "0",
"brandCat": "9223372036854775807",
"catInfo": {
"isRequired": 0,
"isCustomize": 0,
"specType": 0,
"specTypeDesc": "",
"attrTemplateId": "0",
"attrTemplateName": "",
"maxAttrNum": 18,
"editByUser": 0,
"catLevel": 3,
"highestPriceFixing": 0,
"wording": "",
"description": "",
"maxProductNum": 0,
"qualification": "",
"productQualification": "",
"quaNeedAudit": "",
"maxQualificationImg": 0,
"catGroup": 0,
"individualAuditInfo": {
"qualification": "",
"productQualification": "",
"quaNeedAudit": "",
"maxQualificationImg": 0
},
"enterpriseAuditInfo": {
"qualification": "",
"productQualification": "",
"quaNeedAudit": "",
"maxQualificationImg": 0
}
},
"auditId": "0",
"desc": "",
"priority": 0
}
],
"brand": "",
"brandId": "2100000000",
"model": "",
"detail": {
"detailImg": [
"https://wxamusic.wx.qq.with/wxasr/getminipic/zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde?media-id=zncFu89-HApz37MU8ZbwXB-7W09r7a2spQoE8wPrMFG4kgySC04JEIgbjTy8izde&appid=wx678687fa5226e237"
],
"detailVideos": [],
"detailVideoInfo": []
},
"param": [],
"minPrice": 2000,
"expressInfo": {
"templateId": "37927"
},
"totalStockNum": 0
},
"skus": []
},
"leagueExInfo": {
"hasCommission": 1,
"commissionRatio": 8000,
"commissionValue": 1600
},
"shopInfo": {
"name": "Pork belly shop,"
"guaranteeFlag": 0,
"headImgUrl": " http://wx.qlogo.cn/mmhead/Q3auHgzwzM77ia7ibuPAQBJgME8gFF9APicaSpd7evrLCVb5hn2zsUBOw"
}
},
{
"productId": "6565746",
"product": {
"productId": "6565746",
"status": 5,
"info": {
"title": "Testing wigs."
"subTitle": "Testing wigs."
"headImg": [
"https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/5fd316dc0000ef4b0000000043785609000000a000004f50"
],
"category": [
{
"catId": "1001",
"name": ""
},
{
"catId": "1030",
"name": ""
},
{
"catId": "1031",
"name": ""
}
],
"brandId": "2100000000",
"detail": {
"detailImg": [],
"detailVideos": [],
"detailVideoInfo": [],
"desc": "Test Goods"
},
"param": [],
"minPrice": 100,
"expressInfo": {
"templateId": "1024691"
},
"totalStockNum": 39995
},
"skus": [
{
"skuId": "11913889",
"status": 5,
"productSkuInfo": {
"saleParam": [
{
"categorys": [
{
"catId": "35245",
"name": "Choose products,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000000",
"name": "111",
"fCatId": "35245",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 1
}
]
},
{
"categorys": [
{
"catId": "35246",
"name": "Choose a color,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000001",
"name": "3333",
"fCatId": "35246",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 1
}
]
}
],
"thumbImg": "",
"skuCode": "",
"salePrice": 100,
"marketPrice": 100,
"stockInfo": {
"stockNum": 20000
},
"appidForMedia": ""
}
},
{
"skuId": "11915862",
"status": 5,
"productSkuInfo": {
"saleParam": [
{
"categorys": [
{
"catId": "35245",
"name": "Choose products,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000002",
"name": "1112",
"fCatId": "35245",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 2
}
]
},
{
"categorys": [
{
"catId": "35246",
"name": "Choose a color,"
"fCatId": "1031",
"catType": 3,
"bizuin": "3853210889",
"brandCat": "0",
"catInfo": {
"isCustomize": 1,
"editByUser": 0
},
"desc": "",
"priority": 0
},
{
"catId": "1000000000001",
"name": "3333",
"fCatId": "35246",
"bizuin": "3853210889",
"catInfo": {
"editByUser": 1
},
"desc": "",
"priority": 1
}
]
}
],
"thumbImg": "",
"skuCode": "",
"salePrice": 100,
"marketPrice": 100,
"stockInfo": {
"stockNum": 20000
},
"appidForMedia": ""
}
}
]
},
"leagueExInfo": {
"hasCommission": 1,
"commissionRatio": 3300,
"commissionValue": 33
},
"shopInfo": {
"name": "Yuan yuan small cute,"
"guaranteeFlag": 0,
"headImgUrl": " http://wx.qlogo.cn/mmhead/574VdhMFwaETvsGUwOpJsHAWaM3UDznibq3MMMiaOPSt7Ir1ecTLOfJQ/0"
}
}
],
"total": 100
}
# 4. Access to promotional material
# Interface Dxplaination
Through the interface to obtain product promotion materials, including shop appID, product details page Path, promotion copy and promotion of short chain, product pictures, etc.
# Request address
POST https://api.weixin.qq.com/union/promoter/product/generate?access_token=ACCESS_TOKEN
# Request parameters
| attribute | type | Default values | Required | Introductions |
|---|---|---|---|---|
| access_token | string | yes | Interface calling credential | |
| pid | string | yes | Generalized bit PID | |
| productList | Array.<Object> | yes | List of products | |
| productList[].productId | string | yes | Product SPU ID | |
| productList[].appId | string | yes | AppID of the Mini Store where the item is located | |
| productList[].customizeInfo | string | no | Custom parameters up to 80 characters |
# POST sample
{
"pid": "oUnIc49zinb1mtlfB5K-NfGJxxNE_341161518",
"productList": [
{
"productId": "14495788",
"appId": "wxb82530c28"
}
]
}
# Return value
# Object
Returned JSON Data packet
| attribute | type | Introductions |
|---|---|---|
| Errcode | number | Error code |
| errmsg | string | Error message |
| list | Array.<Object> | |
| list[].productId | string | Product SPU ID |
| list[].pid | string | Generalized bit PID |
| list[].productInfo | Object | Product related information |
| list[].shareInfo | Object | Promotion of relevant information |
productInfo Structure
| attribute | type | Introductions |
|---|---|---|
| productId | string | Product SPU ID |
| title | string | Product Title |
| subTitle | string | Product Subtitle |
| headImg | Array.<string> | Product master chart |
| minPrice | number | Minimum price of goods per unit |
| discount | number | Amount of product discount, unit points |
| discountPrice | number | Minimum price after product coupons, unit points |
| shopName | string | Store name |
| pluginResult | number | Whether to reference the Mini Store component (unreferenced components are not promoted), 0: No, 1: Yes |
| totalStockNum | number | Product stock |
shareInfo Structure
| attribute | type | Introductions |
|---|---|---|
| appId | string | Mini Program to promote goods AppID |
| path | string | Mini Programs to promote goods Path |
| couponPath | string | Promotion of goods with coupons Mini Program Path |
| wxaCode | string | Abandoned. Promotion of product details page without coupons sunflower code picture |
| couponWxaCode | string | Abandoned. Picture of Sunflower Code with Coupon on Promotional Product Detail Page |
| promotionUrl | string | Promotion of product short chain |
| couponPromotionUrl | string | Promotion of commodities with coupons short chain |
| promotionWording | string | Promotional Merchandise Copywriting |
| couponPromotionWording | string | Promotion of goods with coupons copy |
# Return Example
{
"errcode": 0,
"errmsg": "ok",
"list": [
{
"pid": "oUkIc71zinc2mtlfC7K-NfGJxxNE_328751529",
"productInfo": {
"productId": "14495674",
"title": "Laundry detergent,"
"subTitle": "",
"headImg": [
"https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/601151160005275c000000003e9f9d09000000a000004f50"
],
"minPrice": 12300,
"shopName": "Pork belly shop."
},
"shareInfo": {
"appId": "wxb825f130c284597f",
"path": "plugin-private://wx34345ae5855f892d/pages/productDetail/productDetail?productId=14495788&ticket=dasdfa2V0NzIx123MTI4MDAxODadfdI4NDE3NabcMA",
"wxaCode": "data:image/jpegbase64,iVBORw0KGgoAAAANSUhEUgAAAa4A",
"promotionWording": " PraiseGood Price FapAffordable pricenN Yellow rice winenN open grab: 123 yuan, 2311 yuan discount than the market price " ，
"promotionUrl": "https://mmbizurl.cn/s/017btcGpB "
}
}
]
}
# Error code
| value | Introductions |
|---|---|
| 201000 | Batch Acquisition of Promotional Material Exception |
| 201001 | Bulk Access Promotion Material Exceeded Limit |