橙积分橙积分
返回首页
返回首页
  • 对接准备
  • 接入方式
    • 客户端接入
    • 微信端接入
  • 对接说明
  • 接口交互流程
  • 术语定义
  • 签名规则
  • 登录接口
    • 接口说明
    • API文档
      • 自定义跳转
        • 跳转到商品详情页面
      • 注意事项
  • 扣积分接口
  • 加积分接口
  • 查积分接口
  • 虚拟商品充值接口
    • 接口说明
    • 虚拟充值接口API文档
    • 充值通知接口API文档
    • 附录
  • 接口文档V1.1.2

API 文档

  • URL 域名

    • 对接环境(测试环境):https://wx1.ejiaofei.com/gateway/user-service/web/auth/autoLogin
    • 正式环境:https://jfwechat.chengquan.cn/gateway/user-service/web/auth/autoLogin
  • 应用参数

    参数名类型必须描述
    uidstring(50)是客户唯一标识
    level_codestring(20)否客户等级标识
    redirectstring否支持跳转到商城的某个页面,支持如下:商品详情页(参数值:/integralStandardH5/#/productDetail?productNo=商品编号)参与签名时不需要URL编码,但是作为参数传递时需要URL编码
  • 请求示例

    https://wx1.ejiaofei.com/gateway/user-service/web/auth/autoLogin?uid=17616191206&app_key=ng7EuNVJmQwEydkOse35&sign=3FBA6CCAE278B517E9E067635C313C3F&timestamp=1708308869481&redirect=%2fintegralStandardH5%2f%23%2fproductDetail%3fproductNo%3d1608
    

自定义跳转

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

跳转到商品详情页面

  • 自定义商品:redirect 参数需设置为 /integralStandardH5/#/productDetail?productNo=商品编号。
  • 额外参数:跳转商品详情页面需要额外传 productNo 参数。

注意事项

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