H5快捷登录服务端对接文档
H5快捷登录认证流程
1) 客户端通过 JS SDK 预取号接口获取 accessCode;
2) 客户端回传 accessCode 至服务端;
3) 服务端通过H5快捷登录接口校验用户输入的手机号是否是本机号;
1. 服务端接口
1.1 H5快捷登录接口
简要描述
使用 JS SDK 预取号获取的 accessCode 及用户输入的手机号校验是否为本机号。
访问授权说明
IP 授权:是,服务端调用
请求URL
Content-Type:application/json
请求参数示例:
{
"key":"9cbcac911c20ca1ab657213fb5a90e85",
"token":"VMHTTPS4681475389749AA210B87BAB2E6CB14C",
"platform":3,
"operator_type":"CM",
"trace_id":"54278C6921844A788F188371FC68109C&eyJ3Y2lkIjoiMTAwMTE2MTY0MDkyODg1NTU2MjY1NTAifQ==",
"user_information":"TGludXggYWFyY2g2NEBATW96aWxsYS81LjAgKExpbnV4OyBVOyBBbmRyb2lkIDEwOyB6aC1jbjsgTUkgOCBCdWlsZC9RS1ExLjE5MDgyOC4wMDIpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIFZlcnNpb24vNC4wIENocm9tZS84OS4wLjQzODkuMTE2IE1vYmlsZSBTYWZhcmkvNTM3LjM2IFhpYW9NaS9NaXVpQnJvd3Nlci8xNS41LjEyQEAyOWEyOGI5OWY2NjczNWQzNDI0MzRhN2Y5N2U2ODU4Nw%3D%3D",
"mobile_verify":"15100001234",
"timestamp":"1627235775685",
"sign":"3b1bebfb233617a87ff3285ef930d21eab74a45bde8e53d2bf3fc60c8ba6f780be3c6e595408f51cbeeadd39dfac7d508628c094e81e8ca3b3f0b392b1e255aa9b5c5c6bbbf488797fc67aa9a873dd97e2de6e87ab1549ee5fef2b630e429560aaad3e368123ddb78fb872b610ba5b925b923bf71e500c63eb71e1715519ecf8"
}
请求参数说明:
参数名 | 必选 | 类型 | 是否参与签名 | 说明 |
key | 是 | String | 是 | 应用 key |
token | 是 | String | 是 | JS SDK预取号获取到的 accessCode |
platform | 是 | Int | 否 | 3:H5 |
operator_type | 是 | String | 是 | JS SDK预取号获取的operatorType CU:联通,CT: 电信,CM:移动 |
user_information | 是 | String | 否 | 透传 JS SDK 预取号返回的userInformation,中国移动该参数必传,中国联通及中国电信该参数为空 |
mobile_verify | 是 | String | 否 | 待校验的手机号 |
trace_id | 是 | String | 否 | 透传 JS SDK 预取号获取的traceId |
timestamp | 是 | String | 是 | 时间戳 |
sign | 是 | String | / | 参数RSA加密值,加密算法:sign=RSA(key=值\&operator_type=值& timestamp=值\&token=值,RSA_Private_key) 转16进制大写,签名算法为:SHA256withRSA。需要注意参数拼接 key升序排序,密钥格式为PSKCS#8,1024位(bit)。其中 RSA_Private_key是合作方的RSA 私钥,合作方需要向平台提供RSA 公钥,用于访问接口时的验签 |
返回示例
{
"code": 0,
"msg": "",
"verify":"bc4c1aceed723941a8e480b898c53b4c"
}
返回参数说明
参数名 | 类型 | 说明 |
code | int | 状态码,0:成功,其他状态码为失败 |
msg | string | 状态码描述信息 |
verify | string | 服务端采用业务端提供的公钥加密,业务端需要使用私钥解密,解密结果值: 0:一致;1:不一致;2:无法判断 |
2. 相关工具
公私钥生成及RSA工具类请参考开发工具包中的: RSA帮助文档