橙积分橙积分
返回首页
返回首页
  • 对接准备
  • 接入方式
    • 客户端接入
    • 微信端接入
  • 对接说明
    • 对接说明
      • 接口请求交互方式
      • 编码格式
      • 签名机制
      • 请在服务端签名
      • 数据交互内容
      • 系统级参数
  • 接口交互流程
  • 术语定义
  • 签名规则
  • 登录接口
    • 接口说明
    • API文档
  • 扣积分接口
  • 加积分接口
  • 查积分接口
  • 虚拟商品充值接口
    • 接口说明
    • 虚拟充值接口API文档
    • 充值通知接口API文档
    • 附录
  • 接口文档V1.1.2

对接说明

接口请求交互方式

在非特殊说明的情况下,橙券积分商城的请求统一都是 HTTP/HTTPS 的 GET/POST 请求方式,响应统一为纯 JSON 字符串 或者纯 文本字符串。

编码格式

橙券积分商城接口请求和响应的参数编码格式,统一使用 UTF-8 编码,开发者如果使用其他编码格式,可能会导致中文乱码,或者签名解析不通过的情况,请务必知晓。

签名机制

橙券积分商城与开发者之间的接口交互请求使用 MD5 签名校验,使得请求无法被伪造和篡改,以确保请求安全。

请在服务端签名

客户端生成签名地址,可能会导致以下问题:

1.客户端易被破解,app_secret 有外泄的风险,危害严重!

2.如果用户的手机端时钟不准,或者不在北京时区,会导致时间验证过期,无法访问。因此签名地址务必在服务器端生成。如不按要求,由此导致的损失,橙券积分商城概不负责!

数据交互内容

橙券积分商城的对接专注于业务核心,在用户数据交互方面只涉及最小化的非敏感用户信息,橙券积分商城通过免登录收到的 uid 来唯一识别用户,不会再要求用户在橙券积分商城提供额外注册信息。

系统级参数

API参数共由系统级参数和应用级参数两部分构成,系统级参数指所有由橙券积分商城提供的API是必须传的参数,应用级参数是指对应API自身所需的参数。

参数名类型必须描述
timestamplong是时间戳,以毫秒为单位。校验合作方与橙券积分商城的时间差,橙券积分商城允许合作方请求最大时间误差为 3 分钟 (3601000)
app_keystring(20)是合作商标识(如:HVEDFeuZUxAy7VDPl3Xc)
signstring(32)是签名 签名规则
Prev
接入方式
Next
接口交互流程