文档中心 > API类目 > 本地生活联盟平台-卡券API

alibaba.alsc.union.eleme.coupon.query (本地联盟卡券列表)

本地联盟卡券列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_request CouponQueryRequest 必须 查询rquest
  • └ session_id
  • String
  • 可选
  • alsc_xxxx
  • 会话ID(查询第一页为空,从第二页开始赋值,取值来自第一页返回结果)
  • └ page_number
  • Number
  • 必须
  • 1
  • 请求页(从1开始)
  • └ page_size
  • Number
  • 必须
  • 20
  • 每页数(1~20)
  • └ item_type
  • String
  • 可选
  • 1|2
  • 商品类型,多值'|'分隔,默认全部(1-商品券;2-代金券)

响应参数

名称 类型 示例值 描述
data PageModel {} 分页数据
  • └ session_id
  • String
  • alsc_unionopen_8497813e6deb4bddac841aca76e3bf8a
  • 会话ID
  • records
  • CouponDto []
  • []
  • 数据
  • └ item_id
  • String
  • 0DE2606D93414EE8ECD84D49995A66D8
  • 商品ID
  • └ item_name
  • String
  • 37店通用|鲜蔬乌冬面套餐|5折限量抢购
  • 标题
  • └ picture
  • String
  • https://img.alicdn.com/i4/2200801151512/O1CN01xvUYrB1N2XYk7esnL_!!2200801151512-0-koubei.jpg
  • 图片
  • └ biz_type
  • String
  • hoard_coupon
  • 商品类型
  • └ original_price_cent
  • Number
  • 10000
  • 原价(分)
  • └ sell_price_cent
  • Number
  • 8000
  • 售价(分)
  • └ start_time
  • Number
  • 1690375813
  • 起始时间(秒)
  • └ end_time
  • Number
  • 1693054213
  • 结束时间(秒)
  • └ commission_rate
  • String
  • 0.1
  • 佣金比例
  • └ commission
  • Number
  • 1000
  • 预估佣金(分)
  • └ apply_city_count
  • Number
  • 12
  • 适用城市数量
  • └ apply_shop_count
  • Number
  • 222
  • 适用门店数量
  • └ item_type
  • Number
  • 1
  • 商品类型(1-商品券;2-代金券)
  • ticket
  • ItemTicket
  • 凭证信息
  • └ price
  • Number
  • 5000
  • 价格(分)
  • └ quantity
  • Number
  • 2
  • 数量
  • └ threshold
  • Number
  • 8000
  • 使用门槛(分)
  • └ total_count
  • Number
  • 100
  • 总数
biz_error_code String 0 错误码
biz_error_message String xxx不正确 错误消息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscUnionElemeCouponQueryRequest req = new AlibabaAlscUnionElemeCouponQueryRequest();
AlibabaAlscUnionElemeCouponQueryRequest.CouponQueryRequest obj1 = new AlibabaAlscUnionElemeCouponQueryRequest.CouponQueryRequest();
obj1.setSessionId("alsc_xxxx");
obj1.setPageNumber(1L);
obj1.setPageSize(20L);
obj1.setItemType("1|2");
req.setQueryRequest(obj1);
AlibabaAlscUnionElemeCouponQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alsc_union_eleme_coupon_query_response>
    <data>
        <session_id>alsc_unionopen_8497813e6deb4bddac841aca76e3bf8a</session_id>
        <records>
            <coupon_dto>
                <item_id>0DE2606D93414EE8ECD84D49995A66D8</item_id>
                <item_name>37店通用|鲜蔬乌冬面套餐|5折限量抢购</item_name>
                <picture>https://img.alicdn.com/i4/2200801151512/O1CN01xvUYrB1N2XYk7esnL_!!2200801151512-0-koubei.jpg</picture>
                <biz_type>hoard_coupon</biz_type>
                <original_price_cent>10000</original_price_cent>
                <sell_price_cent>8000</sell_price_cent>
                <start_time>1690375813</start_time>
                <end_time>1693054213</end_time>
                <commission_rate>0.1</commission_rate>
                <commission>1000</commission>
                <apply_city_count>12</apply_city_count>
                <apply_shop_count>222</apply_shop_count>
                <item_type>1</item_type>
                <ticket>
                    <price>5000</price>
                    <quantity>2</quantity>
                    <threshold>8000</threshold>
                </ticket>
            </coupon_dto>
        </records>
        <total_count>100</total_count>
    </data>
    <biz_error_code>0</biz_error_code>
    <biz_error_message>xxx不正确</biz_error_message>
</alibaba_alsc_union_eleme_coupon_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

返回
顶部