From f1878c0d0368a159f1908f7dd9dd0ffabcef843b Mon Sep 17 00:00:00 2001 From: Jackson Tian Date: Tue, 15 Jul 2014 20:58:59 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=95=86=E5=93=81=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E7=9A=84=E7=9B=B8=E5=85=B3=E6=8E=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- index.js | 2 + lib/api_common.js | 1 + lib/api_shop_goods.js | 571 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 574 insertions(+) create mode 100644 lib/api_shop_goods.js diff --git a/index.js b/index.js index bb207c76..57d77589 100644 --- a/index.js +++ b/index.js @@ -17,6 +17,8 @@ API.mixin(require('./lib/api_customer')); API.mixin(require('./lib/api_custom_service')); // 高级群发接口 API.mixin(require('./lib/api_mass_send')); +// 微信小店商品管理接口 +API.mixin(require('./lib/api_shop_goods')); // 支付接口 API.mixin(require('./lib/api_pay')); diff --git a/lib/api_common.js b/lib/api_common.js index 3728816b..abd3a2d7 100644 --- a/lib/api_common.js +++ b/lib/api_common.js @@ -73,6 +73,7 @@ var API = function (appid, appsecret, token) { this.mpPrefix = 'https://mp.weixin.qq.com/cgi-bin/'; this.fileServerPrefix = 'http://file.api.weixin.qq.com/cgi-bin/'; this.payPrefix = 'https://api.weixin.qq.com/pay/'; + this.merchantPrefix = 'https://api.weixin.qq.com/merchant/'; EventEmitter.call(this); }; inherits(API, EventEmitter); diff --git a/lib/api_shop_goods.js b/lib/api_shop_goods.js new file mode 100644 index 00000000..3796eacf --- /dev/null +++ b/lib/api_shop_goods.js @@ -0,0 +1,571 @@ +/** + * 增加商品 + * 详细请看： + * Examples: + * ``` + * api.createGoods(goods, callback); + * ``` + * Goods: + * ``` + * { + * "product_base":{ + * "category_id":[ + * "537074298" + * ], + * "property":[ + * {"id":"1075741879","vid":"1079749967"}, + * {"id":"1075754127","vid":"1079795198"}, + * {"id":"1075777334","vid":"1079837440"} + * ], + * "name":"testaddproduct", + * "sku_info":[ + * { + * "id":"1075741873", + * "vid":["1079742386","1079742363"] + * } + * ], + * "main_img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0", + * "img":[ + * "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0" + * ], + * "detail":[ + * {"text":"testfirst"}, + * {"img": 4whpV1VZl2iccsvYbHvnphkyGtnvjD3ul1UcLcwxrFdwTKYhH9Q5YZoCfX4Ncx655ZK6ibnlibCCErbKQtReySaVA/0"}, + * {"text":"testagain"} + * ], + * "buy_limit":10 + * }, + * "sku_list":[ + * { + * "sku_id":"1075741873:1079742386", + * "price":30, + * "icon_url": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5K Wq1QGP3fo6TOTSYD3TBQjuw/0", + * "product_code":"testing", + * "ori_price":9000000, + * "quantity":800 + * }, + * { + * "sku_id":"1075741873:1079742363", + * "price":30, + * "icon_url": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5K Wq1QGP3fo6TOTSYD3TBQjuw/0", + * "product_code":"testingtesting", + * "ori_price":9000000, + * "quantity":800 + * } + * ], + * "attrext":{ + * "location":{ + * "country":"中国", + * "province":"广东省", + * "city":"广州市", + * "address":"T.I.T创意园" + * }, + * "isPostFree":0, + * "isHasReceipt":1, + * "isUnderGuaranty":0, + * "isSupportReplace":0 + * }, + * "delivery_info":{ + * "delivery_type":0, + * "template_id":0, + * "express":[ + * {"id":10000027,"price":100}, + * {"id":10000028,"price":100}, + * {"id":10000029,"price":100} + * ] + * } + * } + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success", + * "product_id": "pDF3iYwktviE3BzU3BKiSWWi9Nkw" + * } + * ``` + * @param {Object} goods 商品信息 + * @param {Function} callback 回调函数 + */ +exports.createGoods = function (goods, callback) { + this.preRequest(this._createGoods, arguments); +}; + +/*! + * 增加商品的未封装版本 + */ +exports._createGoods = function (goods, callback) { + var url = this.merchantPrefix + 'create?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(goods), wrapper(callback)); +}; + +/** + * 删除商品 + * 详细请看： + * Examples: + * ``` + * api.deleteGoods(productId, callback); + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success", + * } + * ``` + * @param {String} productId 商品Id + * @param {Function} callback 回调函数 + */ +exports.deleteGoods = function (productId, callback) { + this.preRequest(this._deleteGoods, arguments); +}; + +/*! + * 删除商品的未封装版本 + */ +exports._deleteGoods = function (productId, callback) { + var data = { + "product_id": productId + }; + var url = this.merchantPrefix + 'del?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(data), wrapper(callback)); +}; + +/** + * 修改商品 + * 详细请看： + * Examples: + * ``` + * api.updateGoods(goods, callback); + * ``` + * Goods: + * ``` + * { + * "product_id":"pDF3iY6Kr_BV_CXaiYysoGqJhppQ", + * "product_base":{ + * "category_id":[ + * "537074298" + * ], + * "property":[ + * {"id":"1075741879","vid":"1079749967"}, + * {"id":"1075754127","vid":"1079795198"}, + * {"id":"1075777334","vid":"1079837440"} + * ], + * "name":"testaddproduct", + * "sku_info":[ + * { + * "id":"1075741873", + * "vid":["1079742386","1079742363"] + * } + * ], + * "main_img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0", + * "img":[ + * "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0" + * ], + * "detail":[ + * {"text":"testfirst"}, + * {"img": 4whpV1VZl2iccsvYbHvnphkyGtnvjD3ul1UcLcwxrFdwTKYhH9Q5YZoCfX4Ncx655ZK6ibnlibCCErbKQtReySaVA/0"}, + * {"text":"testagain"} + * ], + * "buy_limit":10 + * }, + * "sku_list":[ + * { + * "sku_id":"1075741873:1079742386", + * "price":30, + * "icon_url": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5K Wq1QGP3fo6TOTSYD3TBQjuw/0", + * "product_code":"testing", + * "ori_price":9000000, + * "quantity":800 + * }, + * { + * "sku_id":"1075741873:1079742363", + * "price":30, + * "icon_url": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5K Wq1QGP3fo6TOTSYD3TBQjuw/0", + * "product_code":"testingtesting", + * "ori_price":9000000, + * "quantity":800 + * } + * ], + * "attrext":{ + * "location":{ + * "country":"中国", + * "province":"广东省", + * "city":"广州市", + * "address":"T.I.T创意园" + * }, + * "isPostFree":0, + * "isHasReceipt":1, + * "isUnderGuaranty":0, + * "isSupportReplace":0 + * }, + * "delivery_info":{ + * "delivery_type":0, + * "template_id":0, + * "express":[ + * {"id":10000027,"price":100}, + * {"id":10000028,"price":100}, + * {"id":10000029,"price":100} + * ] + * } + * } + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success" + * } + * ``` + * @param {Object} goods 商品信息 + * @param {Function} callback 回调函数 + */ +exports.updateGoods = function (goods, callback) { + this.preRequest(this._updateGoods, arguments); +}; + +/*! + * 修改商品的未封装版本 + */ +exports._updateGoods = function (goods, callback) { + var url = this.merchantPrefix + 'update?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(goods), wrapper(callback)); +}; + +/** + * 查询商品 + * 详细请看： + * Examples: + * ``` + * api.getGoods(productId, callback); + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success", + * "product_info":{ + * "product_id":"pDF3iY6Kr_BV_CXaiYysoGqJhppQ", + * "product_base":{ + * "name":"testaddproduct", + * "category_id":[537074298], + * "img":[ + * "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0" + * ], + * "property":[ + * {"id":"品牌","vid":"Fujifilm/富⼠士"}, + * {"id":"屏幕尺⼨寸","vid":"1.8英⼨寸"}, + * {"id":"防抖性能","vid":"CCD防抖"} + * ], + * "sku_info":[ + * { + * "id":"1075741873", + * "vid":[ + * "1079742386", + * "1079742363" + * ] + * } + * ], + * "buy_limit":10, + * "main_img": 4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic 0FD3vN0V8PILcibEGb2fPfEOmw/0", + * "detail_html": "
\"\"

test

\"\"

test again

" + * }, + * "sku_list":[ + * { + * "sku_id":"1075741873:1079742386", + * "price":30, + * "icon_url": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0", + * "quantity":800, + * "product_code":"testing", + * "ori_price":9000000 + * }, + * { + * "sku_id":"1075741873:1079742363", + * "price":30, + * "icon_url": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5KWq1QGP3fo6TOTSYD3TBQjuw/0", + * "quantity":800, + * "product_code":"testingtesting", + * "ori_price":9000000 + * } + * ], + * "attrext":{ + * "isPostFree":0, + * "isHasReceipt":1, + * "isUnderGuaranty":0, + * "isSupportReplace":0, + * "location":{ + * "country":"中国", + * "province":"广东省", + * "city":"⼲州市", + * "address":"T.I.T创意园" + * } + * }, + * "delivery_info":{ + * "delivery_type":1, + * "template_id":103312920 + * } + * } + * } + * ``` + * @param {String} productId 商品Id + * @param {Function} callback 回调函数 + */ +exports.getGoods = function (productId, callback) { + this.preRequest(this._getGoods, arguments); +}; + +/*! + * 根据状态获取商品列表 + */ +exports._getGoods = function (productId, callback) { + var url = this.merchantPrefix + 'get?product_id=' + productId + '&access_token=' + this.token.accessToken; + urllib.request(url, {dataType: 'json'}, wrapper(callback)); +}; + +/** + * 获取指定状态的所有商品 + * 详细请看： + * Examples: + * ``` + * api.deleteGoods(productId, callback); + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success", + * "products_info": [ + * { + * "product_base": ..., + * "sku_list": ..., + * "attrext": ..., + * "delivery_info": ..., + * "product_id": "pDF3iY-mql6CncpbVajaB_obC321", + * "status": 1 + * } + * ] + * } + * ``` + * @param {Number} status 状态码。(0-全部, 1-上架, 2-下架) + * @param {Function} callback 回调函数 + */ +exports.getGoodsByStatus = function (status, callback) { + this.preRequest(this._getGoodsByStatus, arguments); +}; + +/*! + * 获取指定状态的所有商品的未封装版本 + */ +exports._getGoodsByStatus = function (status, callback) { + var data = {status: status}; + var url = this.merchantPrefix + 'getbystatus?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(data), wrapper(callback)); +}; + +/** + * 商品上下架 + * 详细请看： + * Examples: + * ``` + * api.updateGoodsStatus(productId, status, callback); + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success" + * } + * ``` + * @param {String} productId 商品Id + * @param {Number} status 状态码。(0-全部, 1-上架, 2-下架) + * @param {Function} callback 回调函数 + */ +exports.updateGoodsStatus = function (productId, status, callback) { + this.preRequest(this._getGoodsByStatus, arguments); +}; + +/*! + * 商品上下架的未封装版本 + */ +exports._updateGoodsStatus = function (productId, status, callback) { + var data = { + product_id: productId, + status: status + }; + var url = this.merchantPrefix + 'modproductstatus?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(data), wrapper(callback)); +}; + +/** + * 获取指定分类的所有子分类 + * 详细请看： + * Examples: + * ``` + * api.getSubCats(catId, callback); + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success" + * "cate_list": [! + * {"id": "537074292","name": "数码相机"}, + * {"id": "537074293","name": "家⽤用摄像机"}, + * {"id": "537074298",! "name": "单反相机"} + * ] + * } + * ``` + * @param {Number} catId 大分类ID + * @param {Function} callback 回调函数 + */ +exports.getSubCats = function (catId, callback) { + this.preRequest(this._getSubCats, arguments); +}; + +/*! + * 获取指定分类的所有子分类的未封装版本 + */ +exports._getSubCats = function (catId, callback) { + var data = { + cate_id: catId + }; + var url = this.merchantPrefix + 'category/getsub?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(data), wrapper(callback)); +}; + +/** + * 获取指定子分类的所有SKU + * 详细请看： + * Examples: + * ``` + * api.getSKUs(catId, callback); + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success" + * "sku_table": [ + * { + * "id": "1075741873", + * "name": "颜⾊色", + * "value_list": [ + * {"id": "1079742375", "name": "撞⾊色"}, + * {"id": "1079742376","name": "桔⾊色"} + * ] + * } + * ] + * } + * ``` + * @param {Number} catId 大分类ID + * @param {Function} callback 回调函数 + */ +exports.getSKUs = function (catId, callback) { + this.preRequest(this._getSKUs, arguments); +}; + +/*! + * 获取指定子分类的所有SKU的未封装版本 + */ +exports._getSKUs = function (catId, callback) { + var data = { + cate_id: catId + }; + var url = this.merchantPrefix + 'category/getsku?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(data), wrapper(callback)); +}; + +/** + * 获取指定分类的所有属性 + * 详细请看： + * Examples: + * ``` + * api.getProperties(catId, callback); + * ``` + * Callback: + * + * - `err`, 调用失败时得到的异常 + * - `result`, 调用正常时得到的对象 + * + * Result: + * ``` + * { + * "errcode": 0, + * "errmsg": "success" + * "properties": [ + * { + * "id": "1075741879", + * "name": "品牌", + * "property_value": [ + * {"id": "200050867","name": "VIC&"}, + * {"id": "200050868","name": "Kate&"}, + * {"id": "200050971","name": "M&"}, + * {"id": "200050972","name": "Black&"} + * ] + * }, + * { + * "id": "123456789", + * "name": "颜⾊色", + * "property_value": ... + * } + * ] + * } + * ``` + * @param {Number} catId 分类ID + * @param {Function} callback 回调函数 + */ +exports.getProperties = function (catId, callback) { + this.preRequest(this._getProperties, arguments); +}; + +/*! + * 获取指定分类的所有属性的未封装版本 + */ +exports._getProperties = function (catId, callback) { + var data = { + cate_id: catId + }; + var url = this.merchantPrefix + 'category/getproperty?access_token=' + this.token.accessToken; + urllib.request(url, postJSON(data), wrapper(callback)); +}; +