文档中心 > API类目 > 交易开放

taobao.opentrade.group.activtiy.query (组团活动信息查询)

组团购场景下,团购活动信息查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 必须 100 分页参数,每页大小
item_id Number 可选 12345 商品ID
page_index Number 必须 0 分页参数,当前页,以0开始
group_activity_id Number 可选 11111 组团活动id

响应参数

名称 类型 示例值 描述
results GroupActivityResponse [] [] 组团活动信息
  • └ group_activity_id
  • Number
  • 11111
  • 组团活动id
  • └ start_time
  • String
  • 2020-09-01 10:00:00
  • 组团活动开始时间
  • └ end_time
  • String
  • 2020-09-10 10:00:00
  • 组团活动结束时间
  • └ expiration
  • Number
  • 3600
  • 成团有效期,单位为秒
  • └ goal
  • Number
  • 5
  • 成团的目标人数
  • └ group_type
  • Number
  • 0
  • 组团类型,0:拼团;1:团购
  • └ allow_type
  • String
  • all
  • 是否任何账号可开团。whitelist:仅白名单账号可开团 all:任何账号可开团
  • └ item_id
  • Number
  • 123456
  • 商品ID
  • └ discount_price
  • Number
  • 1000
  • 组团购买的折扣价,单位为分,不能低于店铺最低折扣
  • └ fail_process
  • String
  • close
  • 未成团处理办法,close:系统关单;continue:订单继续下行
  • └ open_limit
  • Number
  • 1
  • 组团类型为团购,可限制团长针对一个商品的开团数量上限
  • └ allow_white_list
  • String []
  • ["用户1","用户2"]
  • 允许开团的淘宝账号列表
total_count Number 3 总记录数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OpentradeGroupActivtiyQueryRequest req = new OpentradeGroupActivtiyQueryRequest();
req.setPageSize(100L);
req.setItemId(12345L);
req.setPageIndex(0L);
req.setGroupActivityId(11111L);
OpentradeGroupActivtiyQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<opentrade_group_activtiy_query_response>
    <results>
        <group_activity_response>
            <group_activity_id>11111</group_activity_id>
            <start_time>2020-09-01 10:00:00</start_time>
            <end_time>2020-09-10 10:00:00</end_time>
            <expiration>3600</expiration>
            <goal>5</goal>
            <group_type>0</group_type>
            <allow_type>all</allow_type>
            <item_id>123456</item_id>
            <discount_price>1000</discount_price>
            <fail_process>close</fail_process>
            <open_limit>1</open_limit>
            <allow_white_list>
                <string>[&quot;用户1&quot;</string>
                <string>&quot;用户2&quot;]</string>
            </allow_white_list>
        </group_activity_response>
    </results>
    <total_count>3</total_count>
</opentrade_group_activtiy_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

返回
顶部