企迈云-开放平台

API 3.0

7 新会员

API 3.0 > 7.2 礼品卡api > 7.2.12 查询礼品卡模板详细信息

7.2.12 查询礼品卡模板详细信息

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

场景描述：查询礼品卡模板详细信息

餐饮

请求地址

请求方式	版本信息	请求地址
POST	V3	http://openapi.zvcms.com/v3/coupon/card/getGiftCardTemplateDetail

公共参数

参数	参数类型	是否必填	描述
openId	string	是	密钥Id
grantCode	string	是	授权code
token	string	是	签名，参考《数字签名sign》
timestamp	string	是	当前时间戳
nonce	string	是	随机正整数
params	array	是	业务参数

请求参数

参数	参数类型	是否必填	默认值	描述
id	string	是		卡模板ID

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功或失败代码
message	string	描述
data	array
├amount	int	面值
├applyGoodsType	int	适用商品类型：1-全部商品，2-指定商品，3-指定不适用商品
├applyStoreType	int	适用门店：1-所有门店，2-指定门店，3-指定门店不适用
├bindValidUnit	int	绑定后有效期单位,1-年，2-月
├channel	string	品牌渠道
├createdAt	DateTime	创建时间
├giveCount	int	赠送次数限制
├giveType	int	赠送设置1-不可赠送,2-可赠送
├goodsCategoryIds	string	适用商品分类ids
├goodsIds	string	适用商品ids
├groupId	string	集团ID
├id	string	模板id
├imageUrl	string	卡模板图片地址
├instruction	string	使用说明
├name	string	卡模板名称
├salePrice	string	售价
├sellerId	string	店铺ID
├sellerType	int	店铺类型，2-餐饮，9-零售
├servicePhone	string	客服电话
├status	string	状态，0-未启用，1-启用中，2-已失效
├storeIds	string	适用门店ids
├thirdBizCode	string	优惠券编码（三方业务券编码）
├updatedAt	DateTime	修改时间
├useageMemo	string	用途备注
├validBeginDate	DateTime	有效开始日期
├validEndDate	DateTime	有效结束日期
├validTime	int	有效年/月数
├validType	int	有效期类型，1-长期有效,2.自绑定之日起有效,3-固定日期

请求示例

{
    "openId": "6dc05b4ac175cf316d226252b05cf685",
    "grantCode": "782c281f62",
    "timestamp": "1547186244",
    "nonce": "658965",
    "token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "params": {
        "id": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "amount": "",
        "applyGoodsType": "",
        "applyStoreType": "",
        "bindValidUnit": "",
        "channel": "",
        "createdAt": "",
        "giveCount": "",
        "giveType": "",
        "goodsCategoryIds": "",
        "goodsIds": "",
        "groupId": "",
        "id": "",
        "imageUrl": "",
        "instruction": "",
        "name": "",
        "salePrice": "",
        "sellerId": "",
        "sellerType": "",
        "servicePhone": "",
        "status": "",
        "storeIds": "",
        "thirdBizCode": "",
        "updatedAt": "",
        "useageMemo": "",
        "validBeginDate": "",
        "validEndDate": "",
        "validTime": "",
        "validType": ""
    }
}

异常示例

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

错误码

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