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×tamp=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泄露,由此造成的损失橙券积分商城概不负责。
