## 获取拼团商品参团记录列表(teambuyLogs) >[info] 场景说明:获取拼团商品参团记录列表 ### 是否需要获取用户TOKEN `否` ***** ### 请求地址 ``` POST http://api.xxx.com/teambuy/logs ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 访问TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | tbid | integer | 可选 | 拼团活动ID | | status | integer | 可选 | 成团状态,1=已成团;0=未成团 | | goods\_id | string | 可选 | 拼团商品ID | | ispayed | integer | 可选 | 支付状态,1=已付款;0=未付款 | | teamid | string | 可选 | 参团/组团关联ID | | keyword | string | 可选 | 搜索关键词,匹配拼团商品标题 | | page | integer | 可选 | 当前页 | | page\_size | integer | 可选 | 每页读取多少条记录,默认10条 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "goods_id":29 } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有数据则返回空 | | └ list | list | 必须 | 参团记录列表 | | └ pagination | array | 必须 | 分页信息 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | logid | integer | 必须 | 参团记录ID | | tbid | integer | 必须 | 拼团活动ID | | people | integer | 必须 | 几人团 | | status | integer | 必须 | 成团状态,1=已成团;0=未成团 | | surplus | integer | 必须 | 差几人成团 | | teamid | string | 必须 | 参团/组团关联ID | | leader | integer | 必须 | 是否拼团活动发团者,1=是;0=否 | | created | integer | 必须 | 拼团订单创建时间 | | expired | integer | 必须 | 拼团订单时效,默认24小时未支付订单设置过期、已支付未成团的订单设置为取消或成团 | | pay\_time | integer | 可选 | 拼团订单付款时间 | | timestamp | integer | 可选 | 过期剩余时间戳 | | goods\_id | integer | 必须 | 拼团商品ID | | goods\_name | string | 必须 | 商品名称 | | goods\_image | string | 必须 | 商品图片 | | order\_id | integral | 必须 | 拼单订单ID | | userid | integer | 必须 | 参团用户ID | | username | string | 必须 | 参团用户名 | | nickname | string | 必须 | 参团用户昵称 | | portrait | string | 必须 | 参团用户头像 | 返回`data->pagination`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | integer | 必须 | 当前页 | | page\_size | integer | 必须 | 每一页显示的数据量 | | page\_count | integer | 必须 | 总页数 | | total | integer | 必须 | 总记录数 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "logid": 1, "tbid": "2人团", "people": 2, "leader": 1, "status": 0, "teamid": "49988783999877444", "goods_id": 26, "goods_name": "【以旧换新 门店现货】Samsung/三星 Galaxy S9 SM-G9600曲屏手机", "goods_image": "http://www.xxx.com/data/files/store_2/goods/20181121224125388.jpg", "created": "2021-03-25 13:03:10", "expired": "2021-03-26 13:03:10", "pay_time": "2021-03-25 13:03:46", "order_id": 45, "timestamp": 7203 "surplus": 1, "userid": 30, "username": "weixin0604201111699", "nickname": "牛人不怕虎", "portrait": "https://thirdwx.qlogo.cn/mmopen/vi\_32/YiaiaosoTKoWYiaA6PvH9zh8gBhdGZ0lDe8SD2jj98odSsn0AyrmjMia91hGpgsyd0rGn4DEfgAvLYQZZPPu5WgeGw/132" } ], "pagination": { "page":1, "page_size":10, "page_count":1, "total":1 } } } ```