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

alibaba.alihouse.marketing.adviser.coupon.page (ETC经纪人维度优惠券分页查询)

ETC经纪人维度优惠券分页查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
etc_coupon_page_query_dto ETCCouponPageQueryDTO 可选 入参对象
  • └ biz_type
  • String
  • 必须
  • existing_home
  • 业务线
  • └ adviser_id
  • Number
  • 必须
  • 12345
  • 经纪人id
  • └ page_no
  • Number
  • 必须
  • 1
  • 当前页数
  • └ page_size
  • Number
  • 必须
  • 10
  • 每页数据量
  • └ promotion_scene
  • String
  • 可选
  • VISIT_GIFT
  • 优惠场景(活动类型)
  • └ role_type
  • String
  • 必须
  • broker
  • 当前登录身份

响应参数

名称 类型 示例值 描述
result Result 返回结果
  • └ msg
  • String
  • 成功
  • 返回信息
  • └ code
  • String
  • success
  • 错误码
  • data
  • PageQueryResult
  • 分页结果
  • └ current_page
  • Number
  • 1
  • 当前页码
  • └ page_size
  • Number
  • 20
  • 每页数据量
  • └ total_count
  • Number
  • 100
  • 总数据量
  • └ total_page
  • Number
  • 5
  • 总页数
  • data
  • ETCCouponDetailDTO []
  • 列表数据
  • └ biz_type
  • String
  • existing_home
  • 业务线
  • └ promotion_scene
  • String
  • VISIT_GIFT
  • 优惠场景(活动类型)
  • └ coupon_instance_id
  • String
  • 123456789
  • 券实例id
  • └ status
  • Number
  • 40
  • 卡券状态
  • └ expire_time
  • String
  • 2022-11-11 23:59:59
  • 过期时间
  • └ issue_time
  • String
  • 2022-10-31 20:00:00
  • 领取时间
  • └ promotion_type
  • Number
  • 1
  • 优惠类型
  • └ benefit_text
  • String
  • 利益点文案
  • 利益点文案
  • └ outer_id
  • String
  • 12345
  • 房源id
  • └ adviser_id
  • Number
  • 12345
  • 经纪人id
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihouseMarketingAdviserCouponPageRequest req = new AlibabaAlihouseMarketingAdviserCouponPageRequest();
AlibabaAlihouseMarketingAdviserCouponPageRequest.ETCCouponPageQueryDTO obj1 = new AlibabaAlihouseMarketingAdviserCouponPageRequest.ETCCouponPageQueryDTO();
obj1.setBizType("existing_home");
obj1.setAdviserId(12345L);
obj1.setPageNo(1L);
obj1.setPageSize(10L);
obj1.setPromotionScene("VISIT_GIFT");
obj1.setRoleType("broker");
req.setEtcCouponPageQueryDto(obj1);
AlibabaAlihouseMarketingAdviserCouponPageResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihouse_marketing_adviser_coupon_page_response>
    <result>
        <msg>成功</msg>
        <code>success</code>
        <data>
            <current_page>1</current_page>
            <page_size>20</page_size>
            <total_count>100</total_count>
            <total_page>5</total_page>
            <data>
                <e_t_c_coupon_detail_d_t_o>
                    <biz_type>existing_home</biz_type>
                    <promotion_scene>VISIT_GIFT</promotion_scene>
                    <coupon_instance_id>123456789</coupon_instance_id>
                    <status>40</status>
                    <expire_time>2022-11-11 23:59:59</expire_time>
                    <issue_time>2022-10-31 20:00:00</issue_time>
                    <promotion_type>1</promotion_type>
                    <benefit_text>利益点文案</benefit_text>
                    <outer_id>12345</outer_id>
                    <adviser_id>12345</adviser_id>
                </e_t_c_coupon_detail_d_t_o>
            </data>
        </data>
        <success>true</success>
    </result>
</alibaba_alihouse_marketing_adviser_coupon_page_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

返回
顶部