Skip to content

1. 开通店铺/登录到店铺后台 ​

接口地址:/home/base/openShop

认证:需要登录

请求参数:

参数名类型必填说明
spread_idInteger否推广人ID(如果有推广人)
shop_nameString否店铺名称

成功响应示例:

json
{
  "code": 1,
  "msg": "正在跳转到店铺后台...",
  "data": {
    "redirect": "/merchant/workbench"
  }
}

错误响应示例:

json
{
  "code": 0,
  "msg": "xxx"
}

字段说明:

  • redirect:跳转路径(前端路由)

说明:

  • 此接口用于将普通用户升级为商户并开通店铺
  • 开通店铺后,用户类型会从2(普通用户)变为1(商户)
  • 如果提供了 spread_id,会记录推广关系
  • 如果提供了 shop_name,会设置店铺名称,否则使用默认名称
  • 开通成功后,前端应跳转到商户后台工作台(前端自行判断跳转位置,演示站用的 "redirect": "/merchant/workbench"),前端也可不使用 自己实现
  • 开通店铺会触发 user.login 事件,执行相关业务逻辑
  • 接口会进行风控检测和商户状态检测
  • 开通成功后,需要使用用户端JWT Token请求 /merchantapi/user/user/userDetail 获取商户资料做持久化保存

业务流程:

  1. 用户登录后调用此接口用户 开通或者登录到店铺后台
  2. 如果不是商户 系统自动将用户升级为商户 a. 创建时会检测注销次数 b. 创建时会检测是否有推广人 c. 创建默认角色 d. 提升用户类型为1 e. 创建推广关系 f. 初始化信誉分 g. 创建店铺信息
  3. 如果已经是商户记录登录日志
  4. 进行风控和状态检测
  5. 返回成功,前端跳转到商户后台
  6. 前端使用用户Token换取商户Token