文档中心 > API类目 > 商家营销中心API

taobao.singletreasure.activity.item.query (查询活动下的优惠信息)

分页查询活动下的商品优惠信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_id Number 必须 10489272 活动Id
page_size Number 必须 10 页大小
page_number Number 必须 1 页码

响应参数

名称 类型 示例值 描述
result PageResultDto 返回结果
  • └ message
  • String
  • 成功
  • 系统信息
  • └ total_count
  • Number
  • 95
  • 总数
  • data_list
  • ItemDetailInfo []
  • 查询结果
  • └ limit_check
  • Number
  • 1
  • 限购数
  • └ free_post
  • Boolean
  • false
  • 是否包邮
  • └ end_time
  • String
  • 2017-11-11 11:11:11
  • 活动结束时间
  • └ exclude_areas
  • String
  • 911101
  • 不包邮地区
  • └ is_discard_fen
  • Boolean
  • true
  • 抹分与否
  • └ activity_id
  • Number
  • 489301
  • 活动 id
  • └ start_time
  • String
  • 2017-11-11 11:11:11
  • 活动开始时间
  • └ discount_type
  • Number
  • 1
  • 折扣类型,1 为促销价,2 为打折,4 为减钱
  • └ name
  • String
  • 打折促销
  • 活动名称
  • └ mk_discount
  • Number
  • 7
  • 猫客对应折扣
  • └ promotion_level
  • Number
  • 1
  • 优惠类型,1 为商品级优惠,3 为 SKU 级优惠
  • └ status
  • Number
  • 1
  • 状态,-1 删除,0 暂停,1 征程
  • └ item_id
  • Number
  • 86889
  • 宝贝 id
  • └ discount
  • Number
  • 7
  • 折扣类型,1 为促销价,2 为打折,4 为减钱
  • └ price
  • Number
  • 10000
  • 价格
  • └ is_math_floor
  • Boolean
  • true
  • 是否取整
  • └ crowd_id
  • String
  • 389348
  • 对应的人群 id
  • └ detail_id
  • Number
  • 1333445
  • id
  • └ sku_id
  • Number
  • 123456
  • skuId
  • └ page_number
  • Number
  • 1
  • 页码
  • └ code
  • Number
  • 200
  • 系统编码
  • └ success
  • Boolean
  • true
  • 系统执行成功与否
  • └ size
  • Number
  • 10
  • 返回数量个数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SingletreasureActivityItemQueryRequest req = new SingletreasureActivityItemQueryRequest();
req.setActivityId(10489272L);
req.setPageSize(10L);
req.setPageNumber(1L);
SingletreasureActivityItemQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<singletreasure_activity_item_query_response>
    <result>
        <message>成功</message>
        <total_count>95</total_count>
        <data_list>
            <item_detail_info>
                <limit_check>1</limit_check>
                <free_post>false</free_post>
                <end_time>2017-11-11 11:11:11</end_time>
                <exclude_areas>911101</exclude_areas>
                <is_discard_fen>true</is_discard_fen>
                <activity_id>489301</activity_id>
                <start_time>2017-11-11 11:11:11</start_time>
                <discount_type>1</discount_type>
                <name>打折促销</name>
                <mk_discount>7</mk_discount>
                <promotion_level>1</promotion_level>
                <status>1</status>
                <item_id>86889</item_id>
                <discount>7</discount>
                <price>10000</price>
                <is_math_floor>true</is_math_floor>
                <crowd_id>389348</crowd_id>
                <detail_id>1333445</detail_id>
                <sku_id>123456</sku_id>
            </item_detail_info>
        </data_list>
        <page_number>1</page_number>
        <code>200</code>
        <success>true</success>
        <size>10</size>
    </result>
</singletreasure_activity_item_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

返回
顶部