企迈云-开放平台

API 2.0

API 2.0 > 2.5 优惠券 > 2.5.13 兑换码对应券包列表

2.5.13 兑换码对应券包列表

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

场景描述：兑换码对应券包列表

餐饮

请求地址

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

公共参数

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

请求参数

参数	参数类型	是否必填	默认值	描述
code	string	是		兑换码code
bizType	string	否		业务类型，10-餐饮，11-零售，12-平台

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功或失败代码
message	string	描述
data	array
├amount	int	数量
├id	int	模板ID
├name	int	名称
├validBeginDate	DateTime	有效开始日期
├validDays	int	有效天数
├validEndDate	DateTime	有效结束日期
├validMonths	int	有效月数
├validStartDay	int	生效时间，0-当日生效，1-次日生效
├validType	int	有效期类型，1-固定日期，2-获得券当日/次日开始 x 个自然日内有效,3-获得券当日/次日开始 x 个自然月内有效

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "coupon.exchange-code-template-list",
    "Params": {
        "code": "",
        "bizType": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "amount": "",
        "id": "",
        "name": "",
        "validBeginDate": "",
        "validDays": "",
        "validEndDate": "",
        "validMonths": "",
        "validStartDay": "",
        "validType": ""
    }
}

异常示例

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

错误码

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