文档中心 > API类目 > 天猫好房营销API

alibaba.alihouse.marketing.coupon.exchange (核销优惠券)

核销优惠券

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
etc_coupon_exchange_dto ETCCouponExchangeDTO 必须 入参对象
  • └ consume_id
  • String
  • 可选
  • 12345678
  • 消费id(
  • └ adviser_id
  • String
  • 必须
  • 123456
  • 经纪人id
  • └ role_type
  • String
  • 必须
  • broker
  • 登录身份
  • └ exchange_code
  • String
  • 必须
  • 100000123476
  • 核销码

响应参数

名称 类型 示例值 描述
result Result 返回结果
  • └ msg
  • String
  • 成功
  • 返回信息
  • └ code
  • String
  • success
  • 错误码
  • data
  • Data
  • 返回结果
  • └ discount_rate
  • String
  • 8.1
  • 折扣
  • └ promotion_type
  • Number
  • 1
  • 优惠类型
  • └ benefit_text
  • String
  • 利益点文案
  • 利益点文案
  • └ coupon_instance_id
  • String
  • 123456
  • 卡券实例id
  • └ status
  • Number
  • 10
  • 卡券状态
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihouseMarketingCouponExchangeRequest req = new AlibabaAlihouseMarketingCouponExchangeRequest();
AlibabaAlihouseMarketingCouponExchangeRequest.ETCCouponExchangeDTO obj1 = new AlibabaAlihouseMarketingCouponExchangeRequest.ETCCouponExchangeDTO();
obj1.setConsumeId("12345678");
obj1.setAdviserId("123456");
obj1.setRoleType("broker");
obj1.setExchangeCode("100000123476");
req.setEtcCouponExchangeDto(obj1);
AlibabaAlihouseMarketingCouponExchangeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihouse_marketing_coupon_exchange_response>
    <result>
        <msg>成功</msg>
        <code>success</code>
        <data>
            <discount_rate>8.1</discount_rate>
            <promotion_type>1</promotion_type>
            <benefit_text>利益点文案</benefit_text>
            <coupon_instance_id>123456</coupon_instance_id>
            <status>10</status>
        </data>
        <success>true</success>
    </result>
</alibaba_alihouse_marketing_coupon_exchange_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

返回
顶部