授权单点登录

接口说明

[!NOTE]
本地部署君子签saas后，可通过此接口将君子签saas账户与自有平台账户进行绑定，实现单点登录。

http请求方式

[!NOTE]
POST multipart/form-data

http请求地址

[!NOTE]
$SERVICE_URL/v2/user/bind #其中$SERVICE_URL为生产或测试的地址

http请求参数

[!NOTE]
除公共必填参数外，还需要传以下参数

参数	类型	是否必填	默认值	说明
thirdUserId	string	*		三方用户ID，平台方自己用户ID，确保唯一性
emailOrPhone	string	?		邮箱或者手机
redirectUrl	string	*		跳转地址，如https://abc.xxx.com
platformName	string	?		平台名称,显示绑定页面提示语，（默认：同意将您的账户与君子签电子签约平台账户）
btnColor	string	?		绑定页面按钮颜色，格式：#FF0000
icon	file	?		图标，支持jpg，png，jpeg；大小不超过500KB，

代码实现

JAVA实现

       Map<String, Object> params = bodyParams;
        String url = SERVICE_URL + "/v2/user/bind";
        params.put("thirdUserId", "16XX");  //三方用户ID，平台方自己用户ID 必填
      //params.put("emailOrPhone", "XX");  //邮箱或者手机 非必填
        params.put("redirectUrl", "https://abc.xxx.com");  // 跳转地址
        params.put("platformName", "xxxaa");  //平台名称 非必填，不填默认 君子签电子签约平台

        String str = HttpClientUtils.init().getPost(url, null, params, true);
        System.out.println(str);

http返回参数

[!NOTE]
返回response为application/json的数据，其字段说明如下

参数	类型	是否必返回	说明
success	bool	*	成功true；异常false
msg	string	?	异常时，返回异常原因
resultCode	string	*	异常时返回
data	string	?	单点登录账户绑定链接（支持h5和pc，有效期7天）

data参数说明

参数	类型	是否必返回	说明
h5Link	string	*	H5-单点登录账户绑定链接（有效期7天）
link	string	*	PC-单点登录账户绑定链接（有效期7天）
authStatus	int	*	0：已注册但未提交资料认证，1：审核通过，2：审核不通过，3：企业账号审核中(个人无这个状态)，4：未申请（未注册账号）

[!NOTE]
返回结果，参考：

//正确响应：
{"data":{"authStatus":3,"h5Link":"https://s.sandbox.junziqian.com/i/anony/user/bind/adapter?key=BF572F0053EC472ABCDCCF52XXXXXXX","link":"https://s.sandbox.junziqian.com/i/anony/user/bind/adapter?key=BF572F005xxxxxxu9pw"},"success":true}
//错误响应：
{"msg":"平台绑定账户ID不能为空","resultCode":"BUSINESS_ERROR","success":false}

results matching ""

No results matching ""