帮助中心
进入EZR

1204-查询会员积分

2021-03-02

接口编号 1204

接口说明

1.应用于第三方系统查询会员在EZR的会员可用积分

2.可查可用积分，累计积分，积分流水（不需要查看积分流水的可不返回流水数据）

3.只支持精准查找返回,返回单条数据

4.OldCode,Code,MobileNo必填项(三个都有非空验证)

5.如果ExpiredExcTime为0，则表示永久有效

请求说明

  • HTTP请求方式：POST

  • 返回数据格式：JSON

  • 请求路径：api/cvip/vipbonusget

请求参数


字段类型为空长度描述
OldCodestring否1~16客户卡号
Codestring是0~16Ezr卡号
MobileNostring是0~16手机号：线下卡号、电子卡号、手机号三者必须填一
HaveTransBool否
是否返回积分流水


返回参数


字段类型描述
OldCodestring客户卡号
CodestringEzr卡号
MobileNostring手机号
Bonusint可用积分
BonusTotalint累计积分
TransJson记录流水/当HaveTrans=true传递


Trans数据结构


字段类型描述
TransOriginstring积分来源
TransIdstring流水编号
TransValInt积分变更值（可能为负）
TransDatestring变更时间（yyyy-MM-dd HH:mm:ss）
EffectDatestring生效日期（yyyyMMdd）
ExpiredExcTimestring过期日期（yyyy-MM-dd HH:mm:ss）
RelationNamestring描述


请求参数示例代码（json对象）

{
   "PageSize": 100,
   "PageIndex": 10,
   "LastTime": "2016-05-01 10:20:33:123"
}


系统级返回结果示例（json）

{
   "OldCode": "EZ00001230",
   "Code": "",
   "MobileNo": ""
}

指第三方接口需要返回的结果格式

{
   "Status": true,
   "StatusCode": 200,
   "Msg": "成功",
   "Timestamp": "20150622093101",
   "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
   "Result": 见业务返回结果示例,
}

业务返回结果示例（json对象）：

{
   "OldCode": "EZ00001230",
   "Code": "Ez00001230",
   "MobileNo": "18988888888",
   "Bonus": 100,
   "BonusTotal": 100,
   "Trans": [{
       "TransOrigin": "1 ",
       "TransId": "ezp1232101 ",
       "TransVal": 100,
       "TransDate": "2016-10-11 12：20：30 ",
       "EffectDate": "20161011",
       "ExpiredExcTime": " 2016-10-11 12：20：30 "
   }]
}


5804