免登陆地址接口

原理及说明

兑吧积分商城是一个H5页面,开发者的APP需要支持加载网页。

用户登录兑吧积分商城,需要开发者根据用户信息在服务端生成一个免登录url,通过这个url链接,兑吧才能知道是哪个用户来访问积分商城,并通过credits参数获取用户的积分余额。

为了确保客户端每次请求到都是最新的免登陆url,客户端每次向服务器发的请求不能是固定的,以避免请求被缓存。

兑吧免登录url经过签名,该url地址5分钟失效,请务必在生成地址后立即使用,使用后页面会重定向进入积分商城,登录状态24小时有效。

开发者服务器端需要开发一个支持重定向的接口实现动态生成免登录url地址,该接口地址配置在客户端,用户通过点击该地址访问积分商城。

dbredirect参数

  1. 为了运营可以方便调整直达积分商城内的活动/商品页面,需要开发者实现一个固定的免登录接口入参(dbredirect),根据该参的传值来灵活修改重定向地址。

  2. dbredirect 为兑吧跟开发者共同约定的参数,开发者需要将免登录接口地址填写在兑吧后台(如:http://www.demo.com/api/duiba)。当运营人员在兑吧后台取活动/商品链接时,兑吧会自动把活动/商品链接经过URLEncode编码(UTF-8)后拼接在dbredirect参数上。

  3. 运营在后台取到的链接,比如:http://www.demo.com/api/duiba?dbredirect=http%3a%2f%2ftrade.m.duiba.com.cn%2fcrecord%2frecord%3ffrom%3dlogin

  4. 运营将该链接配置在app客户端的运营位上,用户点击时会首先请求到开发者的服务端接口(http://www.demo.com/api/duiba),服务端解析链接后将dbredirect参数里的值取出,在生成免登录URL时拼接到redirect参数上,然后将免登录URL重定向返回给客户端。

输入参数(Get请求方式传参):

参数 是否必须 参数类型 限制长度 参数说明
uid yes string 255 用户id (用not_login作为uid标记游客用户,详见 游客访问
credits yes long 20 用户积分余额
appKey yes string 255 接口appKey,应用的唯一标识
timestamp yes String 20 1970-01-01开始的时间戳,毫秒为单位。
redirect no string 255 登录成功后的重定向地址,可以直达积分商城内的任意页面,如果不带redirect参数,默认跳转到积分商城首页
sign yes string 255 MD5签名,详见 签名规则

免登陆地址示例:

http://www.duiba.com.cn/autoLogin/autologin?uid=test001&credits=100&appKey=jlg88loSQobWDMmGrPLqtmr&sign=fbce303d7ba7ca7b0fe14d576b494769&timestamp=1418625055000

签名规则说明

所有的请求都会使用md5进行签名,在接口开发前,你需要先获得AppKey和AppSecret。AppKey可以在 基础配置—>应用信息 中找到,AppSecret可以到应用信息中通过邮件方式获取。请务必妥善保管AppSecret,泄露AppSecret可能会让您的账号面临资金被盗等损失。具体签名方法见附录: 签名规则

代码示例

点击下载(java开发包)

java

CreditTool tool=new CreditTool("appKey", "appSecret");
Map params=new HashMap();
params.put("uid","userId001");
params.put("credits","100");
if(redirect!=null){
    //redirect是目标页面地址,如果要跳转到积分商城指定页面,redirect地址就是目标页面地址
    //此处请设置成一个外部传进来的参数,方便运营灵活配置
    params.put("redirect",redirect);
}
String url=tool.buildUrlWithSign("http://www.duiba.com.cn/autoLogin/autologin?",params);
//此url即为免登录url

php

开发工具包: 点击打开

$url=buildRedirectAutoLoginRequest($appKey,$appSecret,$uid,$credits,$redirect)

.net

开发工具包: 点击打开


string url = "http://www.duiba.com.cn/autoLogin/autologin";
string uid = "userId001";
int credits = 9999;

Hashtable hshTable = new Hashtable();
hshTable.Add("uid", uid);
hshTable.Add("credits", credits);
if(redirect!=null){
    //redirect为商城直达的目标页面地址,如果要跳转的目标页面不是积分商城首页,改地址必须配置
    hshTable.Add("redirect", redirect);
}

url = duiba.BuildUrlWithSign(url, hshTable, appKey, appSecret);

results matching ""

    No results matching ""