免登录地址接口

1.免登录url定义

对接开发者从活动或者商城入口跳转到兑吧页面时,实现用户uid身份信息和积分等参数回传的统一接口url地址。通过免登录url实现开发者用户从指定商城入口直接跳转到兑吧页面,不需要再进行二次登录。

注意事项:

免登录url涉及到签名加密以及有效期验证(5分钟有效期),开发者生成免登录地址时需要有服务端动态生成

2.免登录url接口地址

因为请求兑吧的免登录url链接地址是需要开发者服务端动态生成。开发者在用户手机入口配置的地址(后续可以配置到兑吧后台),是要能够请求开发者服务端的接口,该接口实现接收用户登录信息,兑吧商城内页活动或者商品地址(定义参数dbredirect),请求服务端生成免登录url链接的方法地址。

注意

免登录url接口地址在兑吧后台的配置,只是方便开发者运营同学取活动或者商品链接时候拼装完整的免登录链接地址。该接口不会和兑吧有交互,兑吧服务器也不会主动调用此接口。

3.参数定义

1.appKey

兑吧应用唯一标识,注册兑吧应用后分配,可以从后台获取。

2.dbredirect

免登录url接口地址回传开发者服务端时候携带的参数地址,该参数也是兑吧重定向的活动或者商品内页地址。

3.redirect

免登录url链接地址中的参数,该参数决定免登录url跳转重定向之后,跳转到兑吧具体页面的参数地址。

交互流程

4.直达兑吧指定页面和活动页面

在免登录url地址中,redirect参数是决定免登录url地址请求兑吧之后自动重定向到任意指定页面的地址参数,该参数可以是兑吧的商品页面,活动页面,奖品记录页面和任意列表页面。免登录url地址中的redirect参数,可以从免登录接口地址的dbredirect参数获取,下面介绍dbredirect.

透传参数dbredirect

dbredirect参数是兑吧约定默认给开发者免登录接口地址回传的参数。如果在兑吧后台配置了免登录接口地址(请求开发者服务端接口地址),在获取某个商品或者活动地址时候,商品和活动地址会自动作为dbredirect参数拼装在开发者提供的免登录接口地址后面,详见下面步骤。
该参数配置在开发者提供的免登录接口中,在免登录接口请求服务端生成免登陆地址时候,赋值给免登录地址的redirect参数

如果开发者内部规范或者其他原因,在做运营位置直达时候有自己定义好的透传参数,不使用兑吧默认的dbredirect参数。想在获取链接时候,拼接的透传参数名称是自己定义的,可以向兑吧技术支持申请修改默认透传参数dbredirect

dbredirect流程原理详见下图

Step1.配置免登接口到兑吧后台 免登接口示例:https://test.db.com.cn/duibulogin

Step2.复制活动地址配置到客户端入口,活动地址为免登接口+dbredirect+经过URLEncode的活动链接 活动地址示例:

https://test.db.com.cn/duibulogin?dbredirect=https%3A%2F%2Factivity.m.duiba.com.cn
%2Fngame%2Findex%3Fid%3D3382474

Step3.开发者服务端免登接口获取到dbredirect的值后,将dbredirect的值赋值给redirect参数,然后生成带redirect参数的免登URL:

https://activity.m.duiba.com.cn/autoLogin/autologin?uid=test001&credits=100
&appKey=jlg88loSQobWDMmGrPLqtmr&sign=43b5362a9ecbcbc4bf708a5d7c355fa6&timestamp=1418625055000&
redirect=https%3A%2F%2Factivity.m.duiba.com.cn%2Fngame%2Findex%3Fid%3D3382474

【特别提醒】免登录生成工具链接

http://wechat.duiba.com.cn/dbtool

5.未登录用户访问

1. 使用场景

如果开发者想让用户在未登录情况下可以访问积分商城,浏览商品,在有兑换或者参与活动需求时再让用户登录,从而减轻用户登录步骤,提升商品曝光度。针对这种情形,兑吧积分商城支持游客身份登录积分商城。 实现逻辑是在生成免登陆地址时候uid参数设置成 "not_login",用户的 credits 设置成"0",这样定义的用户访问积分商城时,我们将其标记为未登录用户。

2. 使用方式

用户在游客访问模式下参与兑换或者参与活动时候,兑吧会调用开发者提供的登录页面的方法或链接地址让用户进行登录操作。 详见 游客用户唤起登录

results matching ""

    No results matching ""