术语定义
开发者:使用橙券积分商城服务的开发者简称。
积分:开发者与橙券商城对接使用的“虚拟货币单位”,开发者可以自己更改“货币名称”。
服务端:指开发者的服务器,用于接口对接。
客户端:又称用户端,支持 Android(安卓)和 iOS 的客户端接入,比如:微信、纯 H5 方式接入。
免登录URL:又称自动登录 URL,在用户进入橙券积分商城的时候由服务端实时生成,提供用户的登录信息,包含用户
id
和积分值。扣积分接口:用户发起兑换请求后,橙券会向开发者发一个扣积分的 HTTP 请求,开发者接收到请求后,需创建订单、扣除用户相应的积分,并响应相应的信息。
增加积分接口:用户产生增加积分的操作后,橙券会向开发者发一个增加积分的 HTTP 请求,开发者接收到请求后,需创建订单、增加用户相应的积分,并响应相应的信息。
通知接口:用户在橙券兑换成功/失败后,橙券会向开发者发通知请求,告知订单最终结果,开发者需根据通知结果修改本地订单状态,如果结果为失败,还需要退还用户之前扣除的积分。
开发者账号:开发者在橙券注册的账号
app_key:应用的标识码。
app_secret:应用的密钥。
签名:遍历请求参数的值进行 MD5 编码,比对
sign
值,确保请求不可伪造。