Scenario
External system needs to get a member’s available points from EZR.
Direction
External system will call EZR
Call path: api/cvip/vipbonusget
Core Logic
Only single member at a time
Request Parameters
Field | Type | Required | Length | Description |
OldCode | string | at least | 1~16 | Member's unique code (external system) |
Code | string | 1~16 | Member's unique code (in EZR) | |
MobileNo | string | 0~11 | Member's Mobile number | |
WxNo | string | 0~32 | Member’s WeChat OpenID | |
WxUnionId | string | 0~32 | Member’s WeChat UnionID |
Returned Parameters
Field | Type | Length | Description |
OldCode | string | 1~16 | Member's unique code (external system) |
Code | string | 1~16 | Member's unique code (in EZR) |
MobileNo | string | 0~11 | Member's Mobile number |
Bonus | int | Member's available points | |
BonusTotal | int | Member's total points (including used/expired) | |
Trans | JSON | - | Points records |
field of “Trans”:
Field | Type | Length | Description |
TransOrigin | string | Transaction reason | |
TransId | string | Points transaction ID | |
TransVal | Int | Points value | |
TransDate | string | Time when transaction happens | |
EffectDate | string | Time when points will take effect | |
ExpiredExcTime | string | Time when points will expire |
Example Request (JSON)
{
"OldCode": "EZ00001230",
"Code": "",
"MobileNo": "",
“Trans”:”TRUE”
}
Example Returned 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": " 2016-10-11 12:20:30 ",
"ExpiredExcTime": " 2016-10-11 12:20:30 "
}, {
......
}]
}