====== 网店（分销商）接口 ====== ------ ===== 1、获取加盟的供货商列表 ===== === 接口名称 === shop/distributors/list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | supplier_id | int | 供货商ID | | shop_name | string | 供货商店铺名称 | | area_name | string | 所在地区 | | service_tel | string | 客服电话 | ===== 2、获取店铺分类列表 ===== === 接口名称 === shop/goods-classes/list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | parentId | int | 否 | 上一级ID 默认0 -1传回所有数据 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | id | int | 分类ID | | title | string | 分类名称 | | level | int | 当前级别 | | parent_id | int | 上一级ID | ===== 3、添加/编辑店铺分类列表 ===== === 接口名称 === shop/goods-classes/create === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | classId | int | 否 | 分类ID 大于0时为编辑 | | parentId | int | 是 | 上一级ID | | className | string | 是 | 分类名称 | | sorts | int | 否 | 排序号 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | errorCode | string | 错误编号 | | message | string | 错误信息 | ===== 4、删除店铺分类列表 ===== === 接口名称 === shop/goods-classes/delete === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | classId | int | 是 | 分类ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | errorCode | string | 错误编号 | | message | string | 错误信息 | ===== 5、获取自己分销的产品列表 ===== === 接口名称 === shop/goods/list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | supplierId | int | 否 | 供货商ID | | classId | int | 否 | 分类ID | | keyword | string | 否 | 关键字查询 | | productId | string | 否 | 产品ID 多个产品用逗号分隔 | | orderField | string | 否 | 排序字段 shop_price 价格 sales 销量 views 浏览量 send_point 赠送工分 id 时间（默认） | | sortBy | string | 否 | 排序方式 asc 由小到大 desc 由大到小（默认） | | pages| int| 否 | 页数 默认1 | | pageSize| int| 否 | 分页数量 默认10 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | items | data | 详细参数 | | _links | data | 链接地址信息 [[公共返回值|查看]] | | _meta | data | 页面统计信息 [[公共返回值|查看]] | === imems === ^ 名称 ^ 类型 ^ 说明 ^ | id | int | 产品ID | | business_id | int | 供货商ID | | supplier_name | string | 供货商名称 | | prono | string | 产品编号 | | intro | string | 简介 | | name | string | 产品名称 | | shop_price | float | 销售价 | | market_price | float | 市场价 | | pic1 | string | 图片 | | shop_class_id | int | 自定义类别ID | | shop_class_name | string | 自定义类别名称 | ===== 6、移动产品分类 ===== === 接口名称 === shop/goods/move-class === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | productId | string | 是 | 产品ID 多个以逗号分隔 | | classId | int | 是 | 目标分类ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | message | | 错误信息 | | data | | 返回数据 | ===== 7、获取店铺菜单列表 ===== === 接口名称 === shop/menus/list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | menuId | int | 否 | 菜单ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | id | int | 分类ID | | menu_name | string | 菜单名称 | | menu_url | int | 菜单链接地址 | | sorts | int | 排序号 | ===== 8、添加/编辑店铺菜单 ===== === 接口名称 === shop/menus/create === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | menuId | int | 否 | 菜单ID 大于0时为编辑 | | menuName | string | 是 | 菜单名称 | | menuUrl | string | 是 | 菜单链接地址 | | sorts | int | 否 | 排序号 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | errorCode | string | 错误编号 | | message | string | 错误信息 | ===== 9、删除店铺菜单 ===== === 接口名称 === shop/menus/delete === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | menuId | int | 是 | 菜单ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | errorCode | string | 错误编号 | | message | string | 错误信息 | ===== 10、网店配置信息 ===== === 接口名称 === shop/configs/edit === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | shopName | string | 否 | 店铺名称 | | address | string | 否 | 店铺地址 | | tel | string | 否 | 手机 | | logo | string | 否 | 店铺LOGO | | linkMan | string | 否 | 联系人 | | desc | string | 否 | 店铺介绍 | | templateId | int | 否 | 店铺模板ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | message | string | 错误信息 | | | | | ===== 11、获取网店配置信息 ===== === 接口名称 === shop/configs/list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | message | string | 错误信息 | | data | array | 网店信息 | data参数说明 ^ 名称 ^ 类型 ^ 说明 ^ | shop_name | string | 网店名称 | | desc | string | 店铺介绍 | | service_tel | string | 服务电话 | | linkman | string | 联系人 | | address | string | 店铺地址 | | shop_template | int | 模板ID | | shop_template_no | string | 模板编号 | | logo | string | 店铺LOGo | ===== 12、获取店铺广告列表 ===== === 接口名称 === shop/ads/list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | adId | int | 否 | 广告ID | | adType | string | 否 | 广告类型 1 BANNER滚动广告 2 顶部背景 3 手机端滚动广告 4 手机端顶部广告 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | id | int | 分类ID | | ad_name | string | 广告名称 | | ad_link | string | 广告链接地址 | | pic | string | 广告图片 | | ad_type | int | 广告类型 | | ad_type_name | string | 广告类型名称 | | sorts | int | 排序号 | | addtime | string | 添加时间 | ===== 13、添加/编辑店铺广告 ===== === 接口名称 === shop/ads/create === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | adId | int | 否 | 编辑广告ID | | adType | int | 否 | 广告类型 1 BANNER滚动广告 2 顶部背景 3 手机端滚动广告 4 手机端顶部广告 | | adName | string | 是 | 广告名称 | | adUrl | string | 是 | 广告链接地址 | | sorts | int | 否 | 排序号 | | pic | string | 否 | 广告图片 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | message | string | 错误信息 | | data | | 数据 | ===== 14、删除店铺广告 ===== === 接口名称 === shop/ads/delete === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | adId | int | 是 | 菜单ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | message | string | 错误信息 | | data| string | 数据 | ===== 15、获取网店店铺推荐位置 ===== === 接口名称 === shop/shop-recomms/get-place === 请求方式 === GET === 请求参数 === 无 === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | no | string | 推荐位置编号 | | name | string | 推荐位置名称 | ===== 16、添加编辑网店店铺推荐位置产品 ===== === 接口名称 === shop/shop-recomms/create === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | place | string | 是 | 推荐位置 | | proId | string | 是 | 推荐的产品ID | | isDelete | int | 否 | 是否删除 0否 1是 默认为否 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | message | string | 错误信息 | | data| string | 数据 | ===== 17、删除网店店铺推荐位置 ===== === 接口名称 === shop/shop-recomms/delete === 请求方式 === POST === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | place | string| 是 | 推荐位置 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | string | success 成功 error 失败 | | message | string | 错误信息 | | data| string | 数据 | ===== 18、获取网店店铺已用推荐位置 ===== === 接口名称 === shop/shop-recomms/list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | id | int | ID | | user_id | int | 网店ID | | place| string |推荐位置编号 | | pro_count| int | 推荐产品数 | | pro_id| string | 推荐的产品 | | place_name| string | 推荐位置名称 | ===== 19、获取网店店铺推荐位置的产品 ===== === 接口名称 === shop/shop-recomms/detail === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | place | string | 是 | 推荐位置,多个以逗号分隔 place_new 新品 place_hot 热销 place_recomm 推荐 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | id | int | 产品ID | | name | string | 产品名称 | | prono | string | 产品编号 | | market_price | float | 市场价 | | shop_price | float | 销售价 | | pic1 | string | 产品图片 | | add_time | string | 添加时间 | | stock | int | 库存 | | intro | string | 供货商名称 | | business_id | string | 供货商ID | | recommend | string | 推荐位置 | ===== 20、分销商申请 ===== === 接口名称 === distributors/create === 请求方式 === post === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | supplier_id| string| 是 | 供货商id | | member_id| int| 是 | 会员id | | link_man| string| 是 | 联系人 | | link_mobile| string| 是 | 联系电话 | | desc| string| 是 | 备注 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | result | bool | 返回结果 success 成功 error 失败 | | message| string | 返回信息 | ===== 21、分销商申请详情 ===== === 接口名称 === distributors/detail === 请求方式 === get === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | supplier_id| string| 是 | 供货商id | | member_id| int| 是 | 会员id | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | audit_date| string| 审核时间 | | status| string | 状态 0 待审核 10 审核通过 20 审核未过 30 取消合作 | | audit_desc| string | 审核意见 | | supplier_id| string | 供货商id | | link_man| string | 联系人 | | link_mobile| string | 联系人手机| | desc| string |备注 | ===== 22、分销商申请日志 ===== === 接口名称 === distributors/log-list === 请求方式 === get === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | memberId| int| 是 | 会员id | | pageSize| int| 否 | 条数，默认50 | | status| int| 否 | 状态 | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | apply_date| string| 申请时间 | | close_date| string| 取消合作时间 | | audit_date| string| 审核时间 | | status| string | 状态 0 待审核 10 审核通过 20 审核未过 30 取消合作 | | audit_desc| string | 审核意见 | | supplier_id| string | 供货商id | | link_man| string | 联系人 | | link_mobile| string | 联系人手机| | desc| string |备注 | |shop_url|string|店铺地址| |shopName|string|店铺名称| ===== 22、分销商统计 ===== === 接口名称 === distributors/statistics === 请求方式 === get === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | memberId| int| 是 | 会员id | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | supplierNum| int| 供货商数量 | | productNum| int| 产品数量 | | meetingPreparation| int| 待审核会议 | | online| int| 上线会议 | | success| int| 成功举办会议 | | todayPublish| int| 今日举办的会议 | | member| int| 会员数量 | | org| int| 组织者数量| | todayMember| int|今日新增会员 | |todayOrg|int|今日新组织者| ===== 23、获取多个店铺广告列表 ===== === 接口名称 === shop/ads/multi-list === 请求方式 === GET === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | userId | int | 是 | 网店用户ID | | adId | int | 否 | 广告ID | | typeJson| json| 否 | 广告类型:数量 （1 BANNER滚动广告 2 顶部背景 3 手机端滚动广告 4 手机端顶部广告 {"4": 1, "3": 2} ） | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | id | int | 分类ID | | ad_name | string | 广告名称 | | ad_link | string | 广告链接地址 | | pic | string | 广告图片 | | ad_type | int | 广告类型 | | ad_type_name | string | 广告类型名称 | | sorts | int | 排序号 | | addtime | string | 添加时间 | ===== 24、分销商加盟的供货商 ===== === 接口名称 === distributors/have-join === 请求方式 === get === 请求参数 === ^ 参数名称 ^ 参数类型 ^ 是否必填 ^ 说明 ^ | memberId| int| 是 | 会员id | === 返回值 === ^ 名称 ^ 类型 ^ 说明 ^ | data| array| 加盟的供货商id |