企迈云-开放平台

API 2.0

API 2.0 > 7.6 积分操作 > 7.6.4新增积分

7.6.4新增积分

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：新增积分

零售餐饮

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	user.points-add	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
balance	string	是	积分值整数
bizId	string	是	业务标识
customerId	string	是	客户ID
reason	string	是	更改原因:购物送积分,积分兑换等
sourceType	int	是	积分来源途径/方式:1-消费增加 2-关注有礼,3-会员特权,4-商家手动补发,5-积分签到,6-满赠活动,7 抽奖得积分,8-储值赠送,9-资产迁入,10-登录获积分,11-评价得积分,12-完善会员资料得积分【测试 1】
pointsChannel	int	是	积分来源渠道: 1-支付宝 ,2-微信, 3-pos, 4-美团, 5-饿了么, 6-有赞商城, 7-三方, 8-其他,9-口碑，【接口测试时建议填，6，7，8，9中的某一个】

响应参数

参数	参数类型	描述

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.points-add",
    "Params": {
        "balance": "11",
        "bizId": "appPay10190709",
        "customerId": "383933091455959041",
        "reason": "",
        "sourceType": "1",
        "pointsChannel": "7"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": []
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	user.points-add	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
balance	string	是	积分值整数
bizId	string	是	业务标识
customerId	string	是	客户ID
reason	string	是	更改原因:购物送积分,积分兑换等
sourceType	int	是	积分来源途径/方式:1-消费增加 2-关注有礼,3-会员特权,4-商家手动补发,5-积分签到,6-满赠活动,7 抽奖得积分,8-储值赠送,9-资产迁入,10-登录获积分,11-评价得积分,12-完善会员资料得积分【测试 1】
pointsChannel	int	是	积分来源渠道: 1-支付宝 ,2-微信, 3-pos, 4-美团, 5-饿了么, 6-有赞商城, 7-三方, 8-其他,9-口碑，【接口测试时建议填，6，7，8，9中的某一个】

响应参数

参数	参数类型	描述

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.points-add",
    "Params": {
        "balance": "11",
        "bizId": "appPay10190709",
        "customerId": "383933091455959041",
        "reason": "",
        "sourceType": "1",
        "pointsChannel": "7"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": []
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}