服务端API

扫码签到和分享链接跳转授客方案

应用场景

在已实现同步通讯录和免登方案的前提下,在授客一些特定场合有扫码签到或者通过分享链接直接进入授客内部的需求,这一块因为通过外部应用扫码或者分享进入授客没有用户登录的操作,所以要做用户登录和免登跳转的逻辑处理。

扫码或者分享链接进入授客学堂流程图

免登录授客学堂流程图

对接流程

对接参数:
(1)login_url:第三方平台提供的登录url,例:https://xxx.xxx.com/userLogin ,如果扫码或者分享链接进入授客页面没有登录,会携带参数跳转到订阅方提供的login_url上,由第三方平台做用户登录或者获取到用户的登录信息以后,免登回redirect_uri地址上。
(2)redirect_uri:可以正常扫码或者分享链接进入的地址,如果判断登录态失败,授客学堂会添加redirect_uri=xxxx参数(参数值是经base64编码后的回跳地址)跳转到第三平台给的URL,例:https://xxx.xxx.com/userLogin?redirect_uri=xxxx

第三方平台需要进行的开发项目:
(1)login_url跳转以后,第三方平台需要引导客户在第三方平台进行登录或者基于当前用户停留页面获取用户登录信息。
(2)登录成功后重新拼接授客学堂免登地址跳回到授客学堂,携带登录信息使用免登方案跳转回授客学堂,重新拼接的免登地址中redirect_uri参数就是我们给第三方URL传的redirect_uri参数值(保留base64编码后的格式)。