联合黑卡接口文档

联合黑卡 统一授权

版本号 : 1.0.0
部门 : 研发中心
岗位 : java工程师
姓名 : 杨松
邮箱 : yangsong@wdai.com
建立日期 : 2019-03-04
最后更新时间 : 2019-03-04 17:27:40

DOMAIN 域名变量

development：

https://platformvip.wdai.com/api

product：

• 待定

code错误码对照表

API 统一授权接口

第三方通过调用此接口授权成为黑卡平台用户,已经授权过的用户不会重复创建,第三方用户登录也调用此接口获取跳转黑卡平台h5参数。
出于用户信息安全考虑,用户姓名、身份证号、手机号均需要RSA公钥加密,黑卡平台使用私钥自行解密,加密公钥由黑卡平台提供

• 请求类型：POST
• path：/front/authorize/sign
• Content-Type:application/json
• 接口参数：RequestBody

参数说明:

sendData:

{
    "enterpriseAccount": "aaa",
    "secretKey": "a1b2c3",
    "thirdUid": "123",
    "realName": "RSA_ENCRYPT_STR",
    "idNumber": "RSA_ENCRYPT_STR",
    "mobile": "RSA_ENCRYPT_STR"
}

response:

{
  "code": 0,
  "message": "成功！",
  "data": ""
}

fail response

{
  "code": 90001,
  "message": "企业账号密钥不匹配",
  "data": ""
}

返回值说明：

1. code:
   
   • 0为成功
   • 其他均为失败
2. message : 请求失败时为错误说明
3. data : 请求成功返回跳转黑卡用户识别参数

API 授权完毕跳转h5接口

第三方调用授权接口获取到解密uToken后调用此接口跳转到黑卡企业(如黑咖圈、快乐花)h5页面,跳转之后为已登录状态
此接口用于重定向，故对域名有限制，如需访问需黑卡配置支持

• 请求类型：GET
• path：/front/redirect/blackcircle
• Content-Type:application/json
• 接口参数：RequestParam

参数说明:

sendUrl:

```
https://platformvip.wdai.com/api/front/redirect/blackcircle?targetUrl=https://unionvip.wdai.com/app/xsxinsheng/#/Home&encryptToken=a1b2c3
````

response:此接口用于登陆之后重定向至H5，无实际返回值