文档中心 > API类目 > 天猫新零售

tmall.nrt.coupon.template.query (查询券模版)

查询券模版

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_code String 必须 easyHome 业务编码
coupon_template_ids String 必须 12,123,123 券模版id集合
coupon_type Number 必须 4159 券类型

响应参数

名称 类型 示例值 描述
result Result 接口返回model
  • └ code
  • Number
  • 0
  • 错误码
  • model
  • NrtCouponTemplateDTO []
  • 券模版数据
  • └ version
  • Number
  • 123
  • 版本
  • └ total_count
  • Number
  • 500
  • 券总数
  • └ reserve_count
  • Number
  • 100
  • 券剩余数量
  • └ channel
  • String
  • 1
  • 券渠道
  • └ start_fee
  • Number
  • 2000
  • 门槛
  • └ discount
  • Number
  • 1000
  • 面额
  • └ creator
  • String
  • asd
  • 创建人
  • └ modified_by
  • String
  • asd
  • 修改人
  • └ use_time_type
  • Number
  • 1
  • 使用时间类型use_time_type
  • └ use_time
  • Number
  • 20
  • 领取后可以使用的相对时间,秒或天为单位
  • └ start_time
  • String
  • 2020-11-11 11:11:11
  • 使用开始时间:yyyy-MM-dd HH:mm:ss
  • └ end_time
  • String
  • 2020-11-11 11:11:11
  • 使用结束时间:yyyy-MM-dd HH:mm:ss
  • └ status
  • Number
  • 1
  • 券状态
  • └ coupon_type
  • Number
  • 4159
  • 券类型
  • └ coupon_name
  • String
  • 萨达
  • 券名称
  • └ send_start_time
  • String
  • 2020-11-11 11:11:11
  • 发放开始时间yyyy-MM-dd HH:mm:ss
  • └ send_end_time
  • String
  • 2020-11-11 11:11:11
  • 发放结束时间yyyy-MM-dd HH:mm:ss
  • └ coupon_template_id
  • Number
  • 123
  • 券模版id
  • └ uuid
  • String
  • 112dfddfd
  • 发放code
  • └ extra
  • String
  • {"ss":ss}
  • 扩展信息
  • └ message
  • String
  • message
  • message

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrtCouponTemplateQueryRequest req = new TmallNrtCouponTemplateQueryRequest();
req.setBizCode("easyHome");
req.setCouponTemplateIds("12,123,123");
req.setCouponType(4159L);
TmallNrtCouponTemplateQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nrt_coupon_template_query_response>
    <result>
        <code>0</code>
        <model>
            <nrt_coupon_template_d_t_o>
                <version>123</version>
                <total_count>500</total_count>
                <reserve_count>100</reserve_count>
                <channel>1</channel>
                <start_fee>2000</start_fee>
                <discount>1000</discount>
                <creator>asd</creator>
                <modified_by>asd</modified_by>
                <use_time_type>1</use_time_type>
                <use_time>20</use_time>
                <start_time>2020-11-11 11:11:11</start_time>
                <end_time>2020-11-11 11:11:11</end_time>
                <status>1</status>
                <coupon_type>4159</coupon_type>
                <coupon_name>萨达</coupon_name>
                <send_start_time>2020-11-11 11:11:11</send_start_time>
                <send_end_time>2020-11-11 11:11:11</send_end_time>
                <coupon_template_id>123</coupon_template_id>
                <uuid>112dfddfd</uuid>
                <extra>{&quot;ss&quot;:ss}</extra>
            </nrt_coupon_template_d_t_o>
        </model>
        <message>message</message>
    </result>
</tmall_nrt_coupon_template_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部