接口说明

一、免登接口说明

开发者接入积分商城后,用户从客户端进入兑吧积分商城,需要通过特定的URL链接来访问。

接口定义

免登录地址接口,是由开发者服务端开放给客户端,作为积分商城入口的一个接口地址。

免登录接口的主要功能是:在用户访问积分商城时,通过接收客户端传过来的参数信息生成对应的免登录URL,并返回给客户端做重定向。 兑吧通过该接口生成的免登录URL同步用户的登录状态。

交互流程

免登url生成工具

为了方便开发者理解和使用,兑吧提供了免登录地址生成工具,通过工具方法,可以生成对应的免登录地址。 免登录地址生成工具:http://wechat.duiba.com.cn/dbtool

二.未登录用户访问

1. 使用场景

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

2. 使用方式

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

三.直达兑吧商品或活动页面

开发者通过免登接口生成免登url(不含redirect参数)默认进入积分商城首页,如果开发者希望直接进入兑吧某个商品页或活动页面,可以通过免登接口生成带redirect参数(商品或活动页地址)的免登url实现该功能。

透传参数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 免登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

results matching ""

    No results matching ""