文档中心 > API类目 > 阿里体育场馆服务API

qimen.alibaba.alisports.stadiums.discount.template (查询优惠模版)

权益中心通过开放平台查询saas优惠模版信息

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
template_id	String	必须	1		模版id

响应参数

名称	类型	示例值	描述
is_success	Boolean	true	是否成功
model	ParkCouponTemplate		出参
└ personReceiveLimitNum Number 10 每人领取限制数 └ gmtModified Number 1619061007000 修改时间 └ canUsedStadiumIds String [] 适用场馆id └ useTimeType Boolean true 可使用时间类型 true :绝对时间 false:相对时间 └ dailyPersonUsedLimitNumType Boolean true 每人每日使用限制类型，true表示有限制，false表示无限制 └ sendStartTime Number 1617206400000 发送（领取）开始时间 └ description String this is description 描述信息 └ templateId String park_2021041911351587517749730 模版id └ outTemplateId String 590844190252687360 外部模版id └ useEndTime Number 1619798399000 可使用截止时间绝对时间： 2020-01-01 相对时间：领取后 M 天 └ discountTemplateType String PARK_COUPON 优惠模版类型 PARK_COUPON:停车券 └ canUsedParkIds String [] 可使用停车场ID集合 └ balance String demo 库存，剩余数 └ discountType String PARK_AMOUNT 优惠方式 AMOUNT:金额 PARK_HOURS:小时 └ distributionChannel String Ali_E_COMMERCE 分发渠道 MERCHANT_BENEFIT:权益中心 └ sendEndTime Number 1619712000000 发送（领取）结束时间 └ sendTotalLimitNum Number 99 发放限制总量 └ useStartTime Number 1617206400000 可使用开始时间绝对时间： 2020-01-01 相对时间：领取后 N 天 └ thresholdValue Number 0 门槛值，单位分 └ gmtCreate Number 1618803316000 创建时间 └ sendStatusType String ONLINE 发送状态 ONLINE:有效 └ dailySendLimitNum String demo 每日发放限制数 └ hasBeenReceived Boolean true 是否被领取过 └ dailyPersonReceiveLimitNum Number 100 每人每日领取限制数 └ dailyPersonUsedLimitNum Number 10 每人每日使用限制数 └ name String biedb-t003 模板名称 └ sendTotalLimitNumType Boolean true 发放限制总量类型，true表示有限制，false表示无限制 └ dailySendLimitNumType String demo 每日发放限制类型，true表示有限制，false表示无限制 └ dailyPersonReceiveLimitNumType Boolean true 每人每日领取限制类型，true表示有限制，false表示无限制 └ step String demo 保存步骤 CREATE_RECEIVE_INFO:创建发送（领取）信息 └ discountValue Number 1000 优惠金额或者优惠比例（万分位，8000/10000=80%） └ personReceiveLimitNumType Boolean true 每人领取限制，true表示有限制，false表示无限制
msg_info	String	demo	错误信息
msg_code	String	demo	错误码

请求示例

{"template_id":"1"}

响应示例

{
    "is_success":true,
    "model":{
        "personReceiveLimitNum":10,
        "gmtModified":1619061007000,
        "useTimeType":true,
        "dailyPersonUsedLimitNumType":true,
        "sendStartTime":1617206400000,
        "description":"this is description",
        "templateId":"park_2021041911351587517749730",
        "outTemplateId":"590844190252687360",
        "useEndTime":1619798399000,
        "discountTemplateType":"PARK_COUPON",
        "balance":"demo",
        "discountType":"PARK_AMOUNT",
        "distributionChannel":"Ali_E_COMMERCE",
        "sendEndTime":1619712000000,
        "sendTotalLimitNum":99,
        "useStartTime":1617206400000,
        "thresholdValue":0,
        "gmtCreate":1618803316000,
        "sendStatusType":"ONLINE",
        "dailySendLimitNum":"demo",
        "hasBeenReceived":true,
        "dailyPersonReceiveLimitNum":100,
        "dailyPersonUsedLimitNum":10,
        "name":"biedb-t003",
        "sendTotalLimitNumType":true,
        "dailySendLimitNumType":"demo",
        "dailyPersonReceiveLimitNumType":true,
        "step":"demo",
        "discountValue":1000,
        "personReceiveLimitNumType":true
    },
    "msg_info":"demo",
    "msg_code":"demo"
}

验签示例

{"msg_code":"sign-check-failure","msg_info":"Illegal request","is_success":"false"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

阿里体育场馆服务API

qimen.alibaba.alisports.stadiums.discount.template (查询优惠模版)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ