免登录地址接口

API文档

免登 URL 域名

对接环境（测试环境）：

http://test.jfwechat.chengquan.cn/autoLogin

正式环境：

https://jfwechat.chengquan.cn/autoLogin

输入参数(POST/GET请求方式传参)

参数名 类型 是否必须 示例值 描述
uid string 是 4839203890302 用户唯一性标识，对应唯一一个用户且不可变 (用not_login作为uid标记游客用户)
app_key string 是 18888888888 接口app_key，会员账号
timestamp long 是 1557037740232 时间戳，13位毫秒数
sign string 是 app_key=x&app_secret=
x&credits=x&timestamp=
x&uid=x		 签名（带上app_secret，值非空的参数名按照 ASCII 码从小到大排序拼接参数名参数值后 MD5 编码）
credits long 是 10000 用户积分余额，积分业务行为对接模式时，该参数值默认置为0
redirect string 否 /index 登录成功后的重定向地址（需要进行 URLEncode 编码），可以直达积分商城内的任意页面，如果不带redirect参数，默认跳转到积分商城首页，具体可参考“自定义跳转”部分说明
product_id long 否 1 如果需要跳转商品详情页面，商品id必须传递,其他情况可不传
dcustom string 否 avatar%3Dxxxx%26newUser%3D1%26nickname%3Dxxxx 自定义参数（需进行 URLEncode 编码），暂时只在拼团活动场景下使用
vip int 否 1 会员等级参数支持999个等级（0-999）

免登录地址示例

https://jfwechat.chengquan.cn/autoLogin?uid=4839203890302&credits=10000&app_key=18888888888&sign=fbce303d7ba7ca7b0fe14d576b494769&timestamp=1557037740232&vip=2

dcustom 参数说明

开发者对接积分商城拼团活动，其中涉及到新旧用户区分以及用户昵称、用户头像展示需求，此时可以通过特定标识参数dcustom拼接在免登录地址中进行传递。 现版本积分商城dcustom参数拼接字符串中包含如下参数：

  • avatar用户头像地址，请传入图片的 URL 地址
  • newUser新老用户标识，请传入 0 或 1，其中 0 代表老用户、1 代表新用户
  • nickname用户昵称

根据相应的参数通过 "=" 及 "&" 符号拼接出dcustom参数字符串，例如得到字符串avatar=https://jfmem.chengquan.cn&newUser=0&nickname=积分商城用户，然后对拼接出的字符串进行 URLEncode 编码得到avatar%3Dhttps%3A%2F%2Fjfmem.chengquan.cn%26newUser%3D0%26nickname%3D%E7%A7%AF%E5%88%86%E5%95%86%E5%9F%8E%E7%94%A8%E6%88%B7，最后编码过的字符串作为免登接口的dcustom参数。注意，生成免登录地址签名时，dcustom参数应使用 URLEncode 编码前的字符串参与签名。

现阶段dcustom参数只在拼团营销活动中使用，随积分商城发展该参数可能会在其他场景下使用或进行字段的扩充。

自定义跳转

积分商城支持通过免登接口传入特定参数，跳转到积分商城指定页面位置，以满足开发者的个性化需求。

除直接跳转商城首页外，现阶段支持跳转到首页中的特定商品组模块、全部商品页面中的特定商品组模块以及商品购买页面。

跳转商品组模块需要先访问商户后台中的 “商城装修” -> “商城设置” 功能，预先获取商品组模块ID。 跳转商城首页中指定商品组模块，需要设置redirect参数为 /integralMall_v2/index&categoryId=xxxx； 跳转商城全部商品页面中指定商品组模块，需要设置redirect参数为 /integralMall_v2/allProducts&categoryId=xxxx。其中 xxxx 替换为获取的商品组模块ID。

跳转商品购买页面，需要根据商品类型分别设置redirect参数：

  • 由积分商城官方提供的橙券商品，redirect 参数设置为 /integralMall/productDetail
  • 由商户创建的自定义商品，redirect 参数需设置为 /integralMall/entity/productDetail

注：跳转商品购买页面需要额外传 productId 参数。

注意事项
  1. redirect 参数在拼装免登录地址时候需要进行 URLEncode 编码，否则会导致请求解析报错。
  2. 当存在 redirect 参数时，请使用 URLEncode 编码前的redirect参数参与签名计算，否则会出现签名异常问题。
  3. 为了确保客户端每次请求到都是最新的免登录 URL，客户端每次向服务器发的请求不能是固定的，以避免请求被缓存。
  4. 橙券积分商城免登录 URL 经过签名，该 URL 地址5分钟失效，请务必在生成地址后立即使用，使用后页面会重定向进入积分商城，登录状态24小时有效。
  5. 开发者服务器端需要开发一个接口实现动态生成免登录 URL 地址并进行重定向，该接口地址配置在客户端，用户通过点击该地址访问橙券积分商城。
  6. app_secrect 是橙券积分商城签名验证的关键密钥，切勿作为参数加入免登 URL，否则将导致app_secrect泄露，由此造成的损失橙券积分商城概不负责。

results matching ""

    No results matching ""