ECJiaWiki:Api:user/forget password

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 当客户忘记帐号密码时,可按手机号、邮箱等进行找回登录密码。

接口名称

 user/forget_password

Header请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
设备唯一ID device-udid String a46d663d675d4858ea7d0a21c2de06e9 设备的唯一编号 1.3.0
设备客户端类型 device-client String android,iphone,h5,weapp 设备类型的描述 1.3.0
产品编号 device-code String 6015 产品编号 1.3.0
API版本 api-version String 1.6 API接口版本号 1.3.0

举例如下

{
    "device-udid" : "a46d663d675d4858ea7d0a21c2de06e9",
    "device-client" : "weapp",
    "device-code " : "6015",
    "api-version" : "1.6",
}

Body请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
session_id session : sid String(40) eec1ca04e8efbbe098f19aa16eb2764b3d3236d4 从服务端获取的session_id 1.3.0
user_id session : uid Int 100 从服务端获取的 uid 1.3.0
找回途径 type String(10) mobile 找回密码使用的途径,可使用邮箱或手机号,值可为:mobile或email 1.3.0
找回方式的值 value String(50) 13512345678 找回密码使用的途径的值,可使用邮箱或手机号,值可为:13651711566或example@example.com 1.3.0

举例如下

"token":{
      "sid": "eec1ca04e8efbbe098f19aa16eb2764b3d3236d4",
      "uid": 100,
}
"type"  : "mobile",
"value" : "13512345678"

返回参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
返回状态码 status json {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明) 1.3.0
返回信息 data json 请求接口提供的返回信息 1.3.0

成功举例如下

{
      "data" : {
             "验证码发送成功!",
      },
      "status": {
             "succeed": 1,
      }
}

失败举例如下

{
      "status": {
             "succeed": 0,
             "error_code": "mobile_repeat_error",
             "error_desc": "手机号重复,请与管理员联系!"
      }
}
{
      "status": {
             "succeed": 0,
             "error_code": "user_error",
             "error_desc": "用户信息错误!"
      }
}
{
      "status": {
             "succeed": 0,
             "error_code": "send_code_error",
             "error_desc": "验证码发送失败!"
      }
}