登录/身份校验接口
POST
/login
三方提供
该接口由对接方提供,单多啦登录时调用
用户登录时,输入账号密码,调用客户系统接口获取用户基本信息,校验身份有效性。
使用人脸登录时:
- 直接发送Base64照片
- 特征值与用户账号绑定、发用户账号。
使用刷卡登录时
- 直接发送卡号验证;
- 收单机卡号绑定账号,发用户账号
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Authorization
string
必需
通过鉴权算法计算的authorization值,具体算法参考《快速开始>鉴权说明》
DeviceCode
string
设备编号
示例值:
A01
FlowType
string
可选
流程类型:员工交单 FlowTypeUserSubmit
员工取件 FlowTypeUserOut
取件员取件 FlowTypePicker
示例值:
FlowTypePicker
Body 参数application/json
loginType
string
登录方式
根据实际情况选择相应的登录类型,支持:账号密码 AccountPwdLogin
账号 AccountLogin 卡号 CardLogin 卡号转账号 CardAccountLogin 人脸照片 FaceImgLogin 人脸转账号 FaceAccountLogin 企微扫码登录 WechatLogin 飞书扫码登录 FeishuLogin 钉钉扫码登录 DingtalkLogin
userAccount
string
登录人账号
password
string
用户密码
根据需要使用
cardNo
string
卡号
如果使用卡号登录则需要提供
base64
string
人脸或照片的base64编码
如果使用人脸登录则需要提供
示例
{
"loginType": "CardLogin", // 示例中使用的是卡号登录,根据实际情况选择相应的登录类型
"userAccount": "user123", // 登录人账号,必须提供
"password": "123456", // 用户密码,非必填,根据需要使用
"cardNo": "00126", // 卡号,非必填,如果使用卡号登录则需要提供
"base64": "base64_encoded_string" // 人脸或照片的base64编码,非必填,如果使用人脸登录则需要提供
}
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
编码
msg
string
消息
data
object
返回值
userStatus
integer
用户状态
用户是否可以登录(1:可登录;0:不可登录)
userAccount
string
账号
userName
string
用户名
示例
成功示例
{
"code": 200,
"msg": "success",
"data": {
"userStatus": 1,
"userAccount": "zhangsan03",
"userName": "张三"
}
}
最后修改时间: 4 个月前