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" : "此应用未上线"
}