微信公众平台开发者文档
/ 微信商品发布
微信商品发布
商品发布
提交审核/取消发布商品
商品成功创建以后,可以调用该接口申请发布商品。提交审核,商品信息会立即进入扫一扫审核系统。审核通过,商品即发布成功。只有通过审核,处于发布状态的商品,才能被普通用户扫码查看。未发布或审核通过之前的商品,只有白名单内的用户可以查看。
请求示例
HTTP请求方式:POST https://api.weixin.qq.com/scan/product/modstatus?access_token=ACCESS_TOKEN POST数据格式:JSON POST数据例子: { "keystandard": "ean13", "keystr": "6900873042720", "status":"on" }
请求参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 公众号的全局凭据,用于接口调用。 |
keystandard | 是 | 商品编码标准。 |
keystr | 是 | 商品编码内容。 |
status | 是 | 设置发布状态。on为提交审核,off为取消发布。 |
返回示例
正确的JSON返回结果如下:
{ "errcode": 0, "errmsg": "ok" }
返回参数说明
参数 | 说明 |
---|---|
errcode | 0为调用成功,否则返回相关错误码。 |
errmsg | ok为调用成功,否则返回错误提示。 |
设置测试人员白名单
白名单内的测试人员可以查看未发布或审核通过之前的商品信息。
请求示例
HTTP请求方式:POST https://api.weixin.qq.com/scan/testwhitelist/set?access_token=ACCESS_TOKEN POST数据格式:JSON POST数据例子: { "openid":["o1Pj9jmZvwSyyyyyyBa4aULW2mA","o1Pj9jmZvxxxxxxxxxULW2mA"], "username":["afdvvf","abcd"] }
请求参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 公众号的全局凭据,用于接口调用。 |
openid | 否 | 测试人员的openid列表。 |
username | 否 | 测试人员的微信号列表。 |
注意:每次设置均被视为一次重置,而非增量设置。openid、微信号合计最多设置10个。
返回示例
正确的JSON返回结果如下:
{ "errcode":0, "errmsg":"ok" }
返回参数说明
参数 | 说明 |
---|---|
errcode | 0为调用成功,否则返回相关错误码。 |
errmsg | ok为调用成功,否则返回错误提示。 |
获取商品二维码
调用该接口,商户可获得由微信格式生成的商品二维码,用于印刷在包装上标识商品。
请求示例
HTTP请求方式:POST https://api.weixin.qq.com/scan/product/getqrcode?access_token=ACCESS_TOKEN POST数据格式:JSON POST数据例子: { "keystandard": "ean13", "keystr": "6900873042720", "extinfo": "test", "qrcode_size": 64 }
请求参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 公众号的全局凭据,用于接口调用。 |
keystandard | 是 | 商品编码标准。 |
keystr | 是 | 商品编码内容。 |
extinfo | 否 | 由商户自定义传入,建议仅使用大小写字母、数字及-_().*这6个常用字符。 |
qrcode_size | 是 | 二维码的尺寸(整型),数值代表边长像素数,不填写默认值为100。 |
注意:
商户可通过extinfo为同一款产品生成多个二维码,用于区分或作来源判断。例如一款产品虽然只有一个对应的商品ID,但可以为该款产品下每一个单独的商品分配一个extinfo参数用以标识。当用户打开商品主页,或者点击主页内的推广链接时,微信会将extinfo参数透传给商户,商户就能跟踪每一个商品和用户接触的情况。更多商品二维码能力请见“一物一码专区”。
返回示例
{ "errcode":0, "errmsg":"ok", "pic_url":"http://mmbiz.qpic.cn/mmbiz/test/0", "qrcode_url":"http://p.url.cn/hA0P71b9MKc/123" }
返回参数说明
参数 | 说明 |
---|---|
errcode | 0为调用成功,否则返回相关错误码。 |
errmsg | ok为调用成功,否则返回错误提示。 |
pic_url | 商品二维码的图片链接,可直接下载到本地。 |
qrcode_url | 商品二维码的内容,以http://p.url.cn/为前缀,加上pid和extinfo三部分组成。 |