HC小区接口文档

重置员工密码接口文档

查询员工
保存员工
删除员工
重置密码
查询组织

一、接口名称

重置员工密码

二、接口描述

外部系统通过该接口重置员工密码。注意: 该接口需要物业管理员账号登录,因为 storeId 是根据管理员登录信息自动获取的,无需手动传入。

三、接口路径

http://{ip}:{port}/app/user.resetStaffPwd

四、请求方法

POST

五、请求头

参数名称 必填 类型 描述
Authorization String 用户认证token,通过登录接口获取
app-id String 应用ID,由系统分配
transaction-id String 请求流水号,格式:1000000000+YYYYMMDDhhmmss+6位序列
sign String 签名
req-time String 请求时间,格式:YYYYMMDDhhmmss

六、请求参数

6.1 请求体(JSON格式)

参数名称 必填 类型 长度 描述
staffId String 30 员工ID

6.2 请求示例

{
    "staffId": "302022081831710053"
}

七、返回值

7.1 返回数据(JSON格式)

参数名称 必填 类型 长度 描述
code int 11 返回码,0 表示成功,其他表示失败
msg String 250 返回信息
pwd String 250 新生成的随机密码

7.2 返回示例

{
    "code": 0,
    "msg": "成功",
    "pwd": "004117"
}

八、业务逻辑说明

  1. 权限校验

    • 仅允许物业管理员或开发人员调用该接口。
    • 校验 staffId 是否属于当前管理员管理的商户。
  2. 密码重置

    • 生成 6位随机密码,并使用 MD5 加密后更新到数据库。
    • 返回明文密码给调用方。
  3. 数据库操作

    • 查询 store_user 表,校验员工与商户的关联关系。
    • 更新 user 表的密码字段。

九、错误码

错误码 描述
非 0 重置失败,具体错误信息见 msg 字段

十、注意事项

  • 该接口仅限管理员调用,普通员工无权限。
  • 返回的密码为明文,调用方需妥善存储或提示用户修改。