登录/身份校验接口 - 单多啦平台

三方提供 该接口由对接方提供，单多啦登录时调用

用户登录时，输入账号密码，调用客户系统接口获取用户基本信息，校验身份有效性。

使用人脸登录时:

直接发送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成功

application/json

Body

code

integer

编码

必需

msg

string

消息

必需

data

object

返回值

必需

userStatus

integer

用户状态

必需

用户是否可以登录(1：可登录；0：不可登录)

userAccount

string

账号

必需

userName

string

用户名

必需

示例

成功示例异常示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "userStatus": 1,
        "userAccount": "zhangsan03",
        "userName": "张三"
    }
}