联机用户认证
商户实现该接口，用户访问场景通平台时，会把用户认证请求转发到该接口，由商户处理用户认证请求，返回处理结果给场景通平台。
根据不同的项目需求，选择不同的认证方式
请求接口
项目访问配置中的认证接口地址
请求响应格式
application/json
公共参数
请求参数根据项目配置的认证方式而不同
| 认证类型 | 描述 |
|---|---|
| PERSONAL_INFO | 个人信息验证，用户输入身份、编号等信息，业务系统根据信息判定用户是否合法 |
| ACCOUNT_PASSWORD | 账号密码，用户输入账号、密码等信息，业务系统根据信息判定用户是否合法 |
请注意兼容多个认证方式
在场景通平台，项目是默认支持多个认证方式的，接入方需要根据authType来匹配对应的认证方式，并返回对应的认证结果
- 如果认证成功，返回
code=0 - 如果认证失败，返回
code!=0，在msg中返回错误信息
点击查看authType为PERSONAL_INFO时请求参数
- relationType未定义时，默认为
mch:normal - 用户身份、用户编号、用户姓名、用户手机号在接口层面都是可选参数，实际情况根据不同项目配置需要的认证参数实际传到业务系统方
| 字段名 | 必填 | 类型 | 描述 |
|---|---|---|---|
| authType | 是 | String | 认证类型 |
| relationType | 否 | String | 用户身份，项目内定义，如：mch:normal |
| relationSn | 否 | String | 用户编号，身份下唯一，如：学号，工号 |
| customerName | 否 | String | 用户姓名 |
| customerPhone | 否 | String | 用户手机号 |
点击查看authType为ACCOUNT_PASSWORD时请求参数
| 字段名 | 必填 | 类型 | 描述 |
|---|---|---|---|
| authType | 是 | String | 认证类型 |
| customerAccount | 是 | String | 用户账号 |
| customerPassword | 是 | String | 用户密码 |
请求参数加密前示例
{
"authType": "PERSONAL_INFO",
"relationType": "mch:normal",
"relationSn": "relationSn_df7f8b4ed1ad",
"customerName": "小明",
"customerPhone": ""
}
响应公共参数
响应的safeParams加密前参数
| 字段名 | 必填 | 类型 | 描述 |
|---|---|---|---|
| outCustomerNo | 是 | String | 第三方系统中用户唯一编号 |
| name | 是 | String | 用户姓名 |
| nickname | 否 | String | 用户昵称 |
| relationType | 否 | String | 用户身份，项目内定义 |
| relationSn | 否 | String | 用户编号，身份下唯一 |
| phone | 否 | String | 用户手机号 |
| 否 | String | 用户邮箱 | |
| department | 否 | String | 用户部门 |
| address | 否 | String | 用户地址 |
| gender | 否 | int | 用户性别 0:未知 1: 男 2: 女 |
| description | 否 | String | 用户描述 |
| remark | 否 | String | 用户备注 |