企迈云-开放平台

请求地址

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

公共参数

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

请求参数

参数	参数类型	是否必填	默认值	描述
id	string	是		优惠券id

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功或失败代码
message	string	描述
data	array
├id	int	优惠券id
├store_id	int	店铺id
├type	int	优惠券所属平台 1微信 2 口碑
├title	string	优惠券名称
├total	int	优惠券总数量 0-不限制
├number	int	已领取的数量
├used	int	已使用的数量
├amount	string	优惠券金额/折扣
├coupon_type	int	优惠形式 0-指定金额 1-折扣券
├min_amount_use	int	最低使用金额， 0 -不限制
├number_of_user	int	每人限领多少张 0-不限制
├goods_range_type	int	可使用的商品 0-所有商品 1-指定商品
├expire_type	int	有效期类型 0-固定日期 1-领到券当日开始N天内生效 2-领到券次日开始N天内生效
├start_at	int	开始时间
├end_at	int	结束时间
├expire_days	int	N天内生效的N
├desc	string	使用说明
├status	int	状态，是否可用 1可用， 0不可用
├created_at	string	创建时间
├updated_at	string	更新时间
├show_page	int	是否显示在商品详情页 1 显示，0不显示
├scene_type	int	适用场景 1-外卖 2-堂食 3-外卖+堂食 4-买单 5-外卖+买单 6-堂食+买单 7-通用
├only_coupon	int	是否只享受优惠券优惠: 0 不是 1是
├use_per_person_per_day	int	每人每天使用次数: 默认值 0 代表不限制
├is_receive	int	是否可领用: 1 可领用 0 不可领用
├is_use_time_range	int	是否使用时间段: 0 不使用 1使用
├is_koubei	int	是否支持口碑: 0 不支持 1支持
├category	int	0现金券 1买赠券 2限制数量免单券 3erp兑换券(线下用) 4买M送N券
├max_num	int	免单最高金额的几件商品
├min_num	int	免单最低金额的几件商品
├min_num_use	int	订单满几件商品可用 min_amount_use和min_num_use同时满足表示不限制
├coupon_no	string	NULL
├multi_range_type	int	适用门店 0-所有门店 1-指定门店可用 2-指定门店不可用
├shop_ids	string	指定的门店ID
├explain_text	string	优惠券说明
├second_max_num	int	买M送N券 - 次高金额的几件商品
├goods_range_num	int	买M送N券 - 购买数量
├use_category	string	有无门槛
├amount_category	int	优惠券金额
├expire	string	有效期
├scene_type_desc	string	适用场景
├coupon_title	string	面值
├coupon_use_time	array
├0	array
├id	int	自增id
├coupon_id	int	优惠券id
├use_time_start	string	优惠券使用开始时间
├use_time_end	string	优惠券使用结束时间
├created_at	string	优惠券创建时间
├updated_at	string	优惠券修改时间
├use_time_range	array
├0	array
├time	array
├0	string	优惠券使用开始时间
├1	string	优惠券使用结束时间
├coupon_label	string	券标签
├image	string	优惠券图片
├finance_payment	string	财务支付金额（元）
├coupon_scope	string	优惠范围，0套餐整体优惠，1套餐内单品优惠
├amount_limit	int	现金优惠券-折扣减免上限，0不限制

请求示例

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

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "id": "",
        "store_id": "",
        "type": "",
        "title": "",
        "total": "",
        "number": "",
        "used": "",
        "amount": "",
        "coupon_type": "",
        "min_amount_use": "",
        "number_of_user": "",
        "goods_range_type": "",
        "expire_type": "",
        "start_at": "",
        "end_at": "",
        "expire_days": "",
        "desc": "",
        "status": "",
        "created_at": "",
        "updated_at": "",
        "show_page": "",
        "scene_type": "",
        "only_coupon": "",
        "use_per_person_per_day": "",
        "is_receive": "",
        "is_use_time_range": "",
        "is_koubei": "",
        "category": "",
        "max_num": "",
        "min_num": "",
        "min_num_use": "",
        "coupon_no": "",
        "multi_range_type": "",
        "shop_ids": "",
        "explain_text": "",
        "second_max_num": "",
        "goods_range_num": "",
        "use_category": "",
        "amount_category": "",
        "expire": "",
        "scene_type_desc": "",
        "coupon_title": "",
        "coupon_use_time": [
            {
                "id": "",
                "coupon_id": "",
                "use_time_start": "",
                "use_time_end": "",
                "created_at": "",
                "updated_at": ""
            }
        ],
        "use_time_range": [
            {
                "time": [
                    "",
                    ""
                ]
            }
        ],
        "coupon_label": "",
        "image": "",
        "finance_payment": "",
        "coupon_scope": "",
        "amount_limit": ""
    }
}

异常示例

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

错误码

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

2.5.7 优惠券详情

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

场景描述：根据优惠券id，查询优惠券详情

请求地址

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码