总结来源:https://pinapp.gitee.io/w5/api/基于微信小程序群拼后台接口的简洁性,我们制定了一个后台小程序群组界面设计指南和建议。对0-1搭建团购商城有很好的借鉴意义。公告列表接口地址:Api/Banner/lists返回说明//正常返回JSON数据包{"result":"ok","banners":[{}]}商品列表接口地址:Api/Goods/lists?offset=OFFSET&size=SIZE请求参数必填参数说明offset为偏移量size为物品个数返回说明//正常返回JSON数据包{"goods":[{}],"result":"ok"}//DataIf返回为空,返回的json数据包{"goods":[],"result":"ok"}商品详情接口地址:Api/Goods/detail?goods_id=GOODS_ID请求参数参数为必填,表示goods_id为返回的商品IDDescription//正常返回的JSON数据包{"result":"ok","goods":{},"gallery":[{}]}//错误返回的JSON数据包(示例:Goods_IDisinvalid){"result":"fail","error_code":41002,"error_info":"商品已下架或不存在"}订单列表接口地址:api/Weuser/order?offset=离开SET&size=SIZE&token=TOKEN请求参数parameter必填注意offset为偏移量,size为item个数,token为登录token。返回说明//正常返回JSON数据包{"order_list":[{}],"result":"ok"}//返回数据为空,返回JSON数据包{"order_list":[],"result":"ok"}订单详情接口地址:Api/Weuser/getorder?token=TOKEN&order_id=ORDER_ID请求参数参数必填说明order_id为订单IDtoken为登录token返回说明//正常返回JSON数据包{"order":{},"result":"ok"}//万一返回错误JSON数据包(示例:Order_ID无效){"result":"fail","error_code":41001,"error_info":"订单不存在"}生成订单接口地址:http请求方式:POSTApi/weuser/orders?token=TOKEN的每个订单类型需要的json数据包如下:生成单个采购订单{"goods_id":"GOODS_ID","address_id":"ADDRESS_ID","groupbuy":0,"group_order_id":0}生成团购订单{"goods_id":"GOODS_ID","address_id":"ADDRESS_ID","groupbuy":1,"group_order_id":0}生成团购订单{"goods_id":"GOODS_ID","地址_id":"ADDRESS_ID","groupbuy":1,"group_order_id":GROUP_ORDER_ID}请求参数参数为必填说明token为登录tokengoods_id为商品IDaddress_id为用户地址IDgroupbuy是否为团购订单group_order_id为团IDreturndescription//正常返回JSON数据包{"result":"ok","order_id":16}//出错时返回一个JSON数据包(示例为Goods_ID无效){"result":"fail","error_code":41002,"error_info":"该商品不存在"}返回码说明参数说明41002商品不存在42042商品已售罄42042地址不存在41002商品仅限一件人41003群不存在41003群已满41003群已关闭41003已加入此群41002创建订单失败取消订单接口地址:api/Weuser/cancelOrder?token=TOKEN&order_id=ORDER_ID请求参数parameterisrequiredDescriptionorder_id为订单IDtoken为登录token返回描述//正常返回JSON包{"result":"ok"}OrderStatus//订单状态"order_status":{0:"Pendingpayment",1:"Paid,notconfirmed",2:"Confirmed,pendingdelivery",3:"Delivery",4:"Signedfor",5:"交易已取消",6:"Unshippedrefundprocessing",7:"Unshippedrefundsuccessful",8:"发货退款处理",9:"发货退回支付成功”},地址列表接口地址:api/Weuser/addresses?token=TOKEN请求参数参数必填descriptiontoken为登录token返回描述//正常返回JSON数据包{"address_list":[{}],"result":"ok"}添加地址接口地址:(TOKEN需要换成登录token)api/Weuser/address?token=TOKENHTTP请求方式:POSTPOST参数说明:必填参数,表示receive_name为收货人姓名mobile为手机号码province为省IDcity为城市IDdistrict为地区IDaddress_name为地址类别"HOME""WORK"address为详细地址示例:{"receive_name":"RECEIVE_NAME","mobile":"MOBILE","province":"PROVINCE","city":"CITY","district":"DISTRICT","address_name":"HOME","address":"ADDRESS"}返回说明//正常返回JSON包{"result":"ok","address_id":15}修改地址接口地址:(TOKEN需要换成logintoken/ADDRESS_ID需要换成addressID)api/Weuser/address?address_id=ADDRESS_ID&token=TOKENHTTP请求方式:PUTPUT参数说明:必填说明receive_name是收货人姓名mobile是手机phonenumberprovince是省IDcity是城市IDdistrict为地区IDaddress_name为地址类别"HOME""WORK"address为详细地址Example:{"receive_name":"RECEIVE_NAME","mobile":"MOBILE","province":"PROVINCE","city":"CITY","district":"DISTRICT","address_name":"HOME","address":"ADDRESS"}返回说明//正常返回JSON包{"result":"ok"}设置默认address接口地址:(TOKEN需要换成登录令牌/ADDRESS_ID需要换成地址ID)api/Weuser/addresses?token=TOKEN&address_id=ADDRESS_IDHTTP请求方式:PUTPUT参数说明:必填参数statusisDEFAULT示例:{"status":"DEFAULT"}返回说明//正常返回JSON数据包{"result":"ok"}删除地址接口地址:(TOKEN需要替换为logintoken/ADDRESS_ID需要替换为地址ID)Api/Weuser/address?address_id=ADDRESS_ID&token=TOKENHTTP请求方式:DELETE返回指令//正常返回JSON包{"result":"ok"}群列表接口地址:Api/Weuser/groups?offset=OFFSET&size=SIZE&token=TOKEN请求参数参数为需要表明offset是偏移量size为返回的条数。//正常返回JSON数据包{"group_orders":[{}],"result":"ok"}//返回数据为空,返回JSON数据包{"group_orders":[],"result":"ok"}群详情接口地址:api/Weuser/group_orders?token=TOKEN&id=IDRequestparameterparameter必填。id是组ID。returndescription//正常返回JSON数据包{"result":"ok","group_order":{}}//出错时返回JSON数据包(示例为非法组ID){"result":"fail","error_code":41001,"error_info":"该群不存在"}群状态"group_status":{}微信支付接口地址:Api/Weuser/wxpay?token=TOKEN&order_id=ORDER_ID请求参数参数必须填写descriptiontoken为登录tokenorder_id为订单IDreturndescription//正常返回JSON数据包{"param":{"appId":"APPID","nonceStr":"NONCESTR","package":"prepay_id=PREPAY_ID","signType":"MD5","timeStamp":"1528247090","paySign":"PAYSIGN"},"result":"ok"}//出错时返回一个JSON包(以Order_ID不合法为例){"result":"fail","error_code":41001,"error_info":"订单不存在"}返回码说明参数说明41001订单不存在41002商品不存在42042商品已售罄42042地址不存在41002商品限1人41003群不存在41003群已满41003群已关闭41003已加入该群用户信息接口地址:Api/Weuser/me?token=TOKEN请求参数必填参数说明token为登录令牌返回说明//正常returnedJSONpacket{"result":"ok","user_info":{}}//出错时返回一个JSON数据包(示例为无效Token){"result":"fail","error_code":40001,"error_info":"用户验证失败"}微信小程序登录接口地址:api/WeApp/login?code=CODE请求参数parameter必须填写descriptioncodeiswx.login(OBJECT)successreturnparametercodereturndescription//正常返回JSON包{"access_token":"ACCESS_TOKEN","expires":"15282507217200","refresh_token":"REFRESH_TOKEN","result":"ok","user_sn":"4998","token":"TOKEN"}//出错时返回一个JSON数据包(示例为无效Code){"result":"fail","error_code":42032,"error_info":"GetUserinformationfailed"}同步用户信息接口地址:(TOKEN需要换成登录token)Api/WeApp/login?token=TOKENHTTP请求方式:PUTPUT参数说明:该参数需要指明即encryptedData包含敏感数据完整用户信息的加密数据iv是加密算法的初始向量。注:请求参数来自wx.getUserInfo示例:{"iv":"IV","encryptedData":ENCRYPTEDDATA"}返回说明//正常返回JSON数据包{"result":"ok"}通用区域列表接口address:Api/project/regions返回说明//正常返回JSON数据包{"result":"ok","regions":{}}Region数据版本接口地址:Api/Project/data_version?type=region_list请求参数ParameterrequiredDescriptiontypeisregion_listreturndescription//正常返回JSON数据包{"result":"ok","data_version":{"data_key":"region_list","version":"234"}}//返回一个JSON发生错误时的数据包(示例是无效的类型){"result":"fail","error_code":42000,"error_info":"Illegalparameter"}查看物流接口地址:Api/Project/express?order_id=ORDER_IDrequestparameter参数必须填写order_id为订单ID返回描述//正常returnJSON数据包{"shipping":{"traces":[],"shipper":"物流单号","tracking_number":"物流公司"},"result":"ok"}//返回JSON以防万一oferror数据包(例:Order_id无效){"result":"fail","error_code":41001,"error_info":"此订单不存在"}扫码入群
