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

taobao.opentrade.group.query (组团购场景查询商品组团详情)

组团购场景下,查询商品开团详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 10 每页展示条数,不能超过100
open_user_id String 可选 sfasfa 用户openId
page_index Number 可选 1 页数
order_by Number 可选 0 0 返回未成团列表,1 返回已成团列表
item_id Number 必须 1233 商品id
group_activity_id Number 可选 11111 组团活动id
with_expire Boolean 可选 false
  • 默认值:false
  • 是否返回已过期的团,true 返回,false 不返回

    响应参数

    名称 类型 示例值 描述
    results GroupDetailResponse [] [] 团信息
    • └ joined
    • Number
    • 10
    • 已参团人数
    • └ goal
    • Number
    • 50
    • 成团目标数
    • └ group_type
    • Number
    • 0
    • 组团类型,0 拼团 1 团购
    • └ group_id
    • Number
    • 111
    • 团id
    • └ item_id
    • Number
    • 123456
    • 商品id
    • leader
    • RopGroupMemberInfo
    • {"nick":"nick","avatar":"avatar"}
    • 团长信息
    • └ nick
    • String
    • 昵称
    • 昵称
    • └ avatar
    • String
    • http://ali.com/img
    • 用户头像
    • members
    • RopGroupMemberInfo []
    • [{"nick":"nick","avatar":"avatar"}]
    • 团员信息
    • └ nick
    • String
    • 昵称
    • 昵称
    • └ avatar
    • String
    • http://ali.com/img
    • 头像
    • └ done
    • Boolean
    • true
    • 是否成团
    • └ expiration
    • Date
    • 2020-09-18 10:00:00
    • 成团有效截止日期
    • └ payed
    • Number
    • 1
    • 下单付款人数
    • └ member_pay_status
    • Number
    • 1
    • 1-未付款,2-已付款,4-已退款,6-交易成功,8-交易关闭
    • └ group_activity_id
    • Number
    • 11111
    • 组团活动id
    total_count Number 3 总记录数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OpentradeGroupQueryRequest req = new OpentradeGroupQueryRequest();
    req.setPageSize(10L);
    req.setOpenUserId("sfasfa");
    req.setPageIndex(1L);
    req.setOrderBy(0L);
    req.setItemId(1233L);
    req.setGroupActivityId(11111L);
    req.setWithExpire(false);
    OpentradeGroupQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <opentrade_group_query_response>
        <results>
            <group_detail_response>
                <joined>10</joined>
                <goal>50</goal>
                <group_type>0</group_type>
                <group_id>111</group_id>
                <item_id>123456</item_id>
                <leader>
                    <nick>昵称</nick>
                    <avatar>http://ali.com/img</avatar>
                </leader>
                <members>
                    <rop_group_member_info>
                        <nick>昵称</nick>
                        <avatar>http://ali.com/img</avatar>
                    </rop_group_member_info>
                </members>
                <done>true</done>
                <expiration>2020-09-18 10:00:00</expiration>
                <payed>1</payed>
                <member_pay_status>1</member_pay_status>
                <group_activity_id>11111</group_activity_id>
            </group_detail_response>
        </results>
        <total_count>3</total_count>
    </opentrade_group_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

    返回
    顶部