术语定义

开发者:兑吧活动工具使用者的简称。

免登录URL:由免登录接口生成,用户访问该链接可跳转进入兑吧活动页面。注:免登录的定义是用户id由开发者传给兑吧,作为用户的唯一识别凭证,不需要用户在积分商城内再次登录。

活动页面链接:兑吧内部活动页面的链接地址。兑吧后台会自动将其通过dbredirect参数拼接在免登录接口上,需通过免登录接口跳转,不可直接访问。填写免登录接口后,可以在活动列表页面获取。

dbredirect:由客户端传给服务端的重定向参数,该参数用于携带活动页面链接。

免登录接口

免登录接口:是开发者用来接收客户端回传的用户标识(uid)和活动链接地址(dbredirect)。并根据相应参数,生成对应用户的免登陆地址的接口。兑吧根据uid来区分不同的用户,关联用户活动的参与次数和奖品发放情况。

注意事项

免登录URL需经过 MD5 签名,该链接地址 5 分钟失效,请务必在生成后立即使用,用户访问免登录URL后即可进入活动页面,登录状态 24 小时有效。如果开发者事先生成免登录URL,将会导致 5 分钟后用户访问该地址过期。

为了确保用户每次点击都获取到最新的链接,客户端应避免请求被缓存。

用户唯一标识:uid

兑吧通过用户标识uid来识别是哪个用户参加的活动,从而发放奖品给参加活动中奖的用户。

开发者可以根据自身的需求情况,可在以下两种方式中选择(交互流程可参考图一,图二)。

以设备号为用户标识

  • 优点:游客可直接参与活动,提高了流量流入。技术上也不用对接唤起登录的功能,方便简单。
  • 缺点:只有在原生的app中才能获取到设备标识,有一定的局限性。

以开发者的用户id作为用户标识

  • 优点:只有在用户登录情况下才可参与活动,提高游客的注册量;同时用户在开发者与兑吧中的用户id相互对应,安全性高。
  • 缺点:需要额外对接唤起登录功能。请参考文档 游客(未登录用户)唤起登录

免登录接口原理图

交互流程图

1. 使用设备号作为uid的对接方式

设备号作为uid方式

2. 以开发者的用户id作为uid的对接方式

用户id作为uid方式

results matching ""

    No results matching ""