通用接口

手机令牌验证接口

请求地址

https://authtest.hengchanglt.com/api/v1/validatesecret

请求方式

POST(服务器直接请求)

参数说明

参数名称 参数类型 是否必须 参数说明
usermail string 可选 要验证的用户邮箱 (邮箱,EHRID,手机号三个字段必须有一个不为空)
mobile string 可选 要验证的用户手机号
ehrid string 可选 要验证的用户EHRID
appkey string 必须项 应用经过认证的key
secret string 必须项 要验证的手机口令

错误说明

正确结果会返回code 200 其余错误请参考最下错误代码及详情

说明 由于企业微信的用户标识是邮箱, 没有EHRID标识。本系统,通过用户邮箱调用公司内部API查询EHRID。由于数据原因,存在用户邮箱查不到EHRID的情况,也存在EHRID找不到用户的情况, 请务必确认用户在EHR系统中维护了企业微信中对应邮箱。

返回结果

验证成功

{
    "code":200,
    "errmsg":"success",
}

验证失败

{
    "code":400,
    "errmsg":"secret is incorrect or expired!"
}

出错

{
    "code":400,
    "errmsg":"Invaild appkey, please check it.", #报错信息
    "data":"appkey" #出错的数据
}

调用样例

请求url:https://10.150.27.163/api/v1/validatesecret
请求data:{"usermail":"zhangsan@credithc.com", "appkey":"testkey" ,"secret":"testsecret"}
返回结果:{"code":400,"errmsg":"secret is incorrect or expired!"}

错误统一代码及详情

错误代码 错误信息 说明
90001 Invaild appkey, please check it 应用key非法,不正确
91001 usermail is not exist 用户邮箱不在
91002 user is not exist or pwd is incorrect 用户不存在或密码错误
91003 Invaild usermail, please check it 无效邮箱
92001 auth_code is invaild or expired auth_code 无效或已过期
92001 access_token is invaild or expired access_token 无效或已过期
93001 api can't find user by mobile 通过手机号,无法找到有效用户
93002 api can't find user by ehrid 通过EHRID,无法找到有效用户
93003 usermail and ehrid and mobile are all empty 邮箱,EHRID,手机号同时为空
93004 Too many times failure, user has been locked. Please try again after 5 minutes 验证失败超过10次,用户锁定5分钟
93005 secret is incorrect or expired 手机口令不正确或者已过期

results matching ""

    No results matching ""