points/change
目录 |
1.接口说明
1.1接口描述
积分增加
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
积分增加
3.接口调用说明
3.1请求说明
url | https://api.yonyouup.com/api/points/change |
格式 | JSON |
https请求方式 | POST |
编码类型 | UTF-8 |
3.2url参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
from_account | string | 是 | 调用方id |
to_account | string | 是 | 提供方id |
app_key | string | 是 | 应用编码 |
token | string | 是 | api调用唯一识别码 |
ds_sequence | number | 否 | 数据源序号(默认取应用的第一个数据源) |
3.3请求体参数说明
参数 | 类型 | 参数路径 | 是否必填 | 描述 |
---|---|---|---|---|
mid | string | 是 | 会员统一id | |
action_type | string | 是 | 积分计算业务类型(5:商城送积分 51:商城抵现 16:退货扣积分 17:退货返还抵扣积分 200:积分结转 | |
ori_money | string | 是 | 业务发生金额 | |
calc_money | string | 是 | 积分计算金额、退货积分返回金额 | |
ori_points | string | 是 | 抵扣积分(正数)、退货扣除积分(正数)、结转积分 | |
cur_points | string | 否 | 会员当前积分 | |
multiple | string | 否 | 积分核算倍数 | |
extra_points | string | 否 | 额外赠送积分 | |
extra_memo | string | orders | 否 | 额外赠送积分备注 |
source_code | string | 是 | 来源依据(订单编号) | |
source1 | string | 否 | 来源依据1、退货时原订单编号 | |
source2 | string | 否 | 来源依据2 |
3.4请求示例
POST https://api.yonyouup.com/yilian/points/change?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296 POST 内容: [ { "mid":34, "action_type":5, "time":"2015-12-12 00:00:00", "ori_money":100, "calc_money":100, "calc_ points":-200, "ori_points":100, "multiple":2, "extra_points":20, "extra_memo ":"满500元额外赠送2000积分", "source_code":"201512120000001", "source1":"201512120000001", "source2":"201512120000001" } ]
3.5返回参数说明
参数说明 | 类型 | 参数路径 | 描述 |
---|---|---|---|
errcode | string | 错误码,0 为正常。 | |
errmsg | string | 错误信息。 | |
id | string | 积分明细记录id | |
mid | string | 会员统一id | |
action_type | string | 积分计算业务类型(5:商城送积分 51:商城抵现 16:退货扣积分 17:退货返还抵扣积分 200:积分结转 | |
ori_money | string | 业务发生金额 | |
calc_money | string | 积分计算金额、退货积分返回金额 | |
ori_points | string | 抵扣积分(正数)、退货扣除积分(正数)、结转积分 | |
cur_points | string | 会员当前积分 | |
multiple | string | 积分核算倍数 | |
extra_points | string | 额外赠送积分 | |
extra_memo | string | orders | 额外赠送积分备注 |
source_code | string | 来源依据(订单编号) | |
source1 | string | 来源依据1、退货时原订单编号 | |
source2 | string | 来源依据2 |
3.6正确返回示例
JSON示例:
{ "errcode":0, "data":[ { "id":11000, "mid":"10000001", "action_type":"200", "time":"2015-12-12 00:00:00", "ori_money":100, "calc_money":100, "before_points":1000, "calc_points":500, "after_points":1500, "multiple":2, "extra_points":20, "source1":"201512120000001", "source2":"201512120000001" } ] }
3.7错误返回示例
application/json;charset=UTF-8 { "errcode" : "30021", "errmsg" : "此应用未上线" }