| 参数名称 | 类型 | 是否必填 | 参数描述 | 备注 |
|---|---|---|---|---|
| api_key | String | 是 | 系统分配的ApiKey | |
| api_target | String | 是 | 调用接口名称 | com_cmall_familyhas_api_ApiForGetLiveRoomList |
| api_input | String | 是 | 输入参数 | 应用输入参数的JSON格式 |
| 参数名称 | 类型 | 必填 | 示例 | 参数描述 | 备注 |
|---|---|---|---|---|---|
| page | int | 是 | 分页页码 | 第几页数据 | |
| version | int | 否 | 版本号 | 仅用于扩展，无需传入 |
| 参数名称 | 类型 | 参数描述 | 备注 |
|---|---|---|---|
| liveRoomList | LiveRoom[] | 直播房间列表 | |
| resultCode | int | 返回标记 | 如果返回标记1则为API调用成功 否则则是错误编号 |
| resultMessage | String | 返回消息 | 返回的消息描述 |
| totalPage | int | 分页总页码 |
| 参数名称 | 类型 | 参数描述 | 备注 |
|---|---|---|---|
| startTime | String | 预计开播时间 | |
| liveRoomProdNum | int | 直播商品总数 | |
| fileId | String | 回放文件编号 | 直播间回放专用,用于区分多个回放文件的直播 |
| liveStatus | String | 房间状态 | 未开始(预告):449746320001 / 已结束(回放):449746320002 / 直播中:449746320003 |
| liveCoverPicture | String | 直播封面图 | |
| liveRoomId | String | 直播房间编号 | |
| videoUrl | String | 回放文件地址 | |
| liveProdList | LiveProd[] | 直播商品集合 | |
| liveTitle | String | 房间名称 | |
| lookNum | int | 观看总数 |
| 参数名称 | 类型 | 参数描述 | 备注 |
|---|---|---|---|
| updateTime | String | 更新时间 | |
| width | long | 商品列表图片宽 | |
| eventLabelPicSkip | String | 活动图片跳转链接 | 396需求 活动图片跳转链接 |
| labelPosition | String | 标签自定义位置 | 449748430001.左上 449748430005.通栏下 |
| endTime | String | 结束时间 | |
| flagEnable | Integer | 是否可用 | 1：可用，0：不可用 |
| startTime | String | 开始时间 | |
| height | long | 商品列表图片高 | |
| listPic | String | 商品列表图片 | |
| excludeLive | String | 排除直播品 | 449747110002 是 449747110001 否 |
| infoPic | String | 商品详情图片 | |
| infoActivityPic | String | 商品详情活动标签 | 接口返回eventLabelPic 396需求 活动图片，比如618活动的横条 |
| labelName | String | 标签名称 | |
| labelCode | String | 标签编号 |
| 参数名称 | 类型 | 参数描述 | 备注 |
|---|
| 参数名称 | 类型 | 参数描述 | 备注 |
|---|---|---|---|
| sellPrice | String | 销售价/拼团商品展示价 | |
| stockNum | String | 是否有货 | 抢光了/有货 |
| productCode | String | 商品编号 | |
| mainpicUrl | String | 商品主图 | |
| allSkuRealStock | int | 商品下的所有sku实际库存 | |
| proClassifyTag | String | 添加商品分类(LD商品,普通商品,跨境商品,跨境直邮,平台入驻,缤纷商品)标签字段 | |
| collagePersonCount | String | 几人团 | 需要几人参团，字符串类型的数字 |
| labelsInfo | PlusModelProductLabel[] | 商品标签详细信息 | |
| productType | String | 是否拼团商品 | 是：4497472000050001，否：4497472000050002 |
| tagInfoList | TagInfo[] | 带样式的商品活动标签 | |
| productStatus | String | 商品状态 | 4497153900060002:上架 |
| markPrice | String | 市场价/拼团商品原价 | |
| tagList | String[] | 标签集合 | 秒杀、闪购、拼团、特价、会员日、满减、赠品（最多展示三个） |
| groupBuying | String | 拼团标识 | 拼团编码：4497472600010024 |
| productName | String | 商品名称 |
| 参数名称 | 类型 | 参数描述 | 备注 |
|---|---|---|---|
| style | String | 标签样式 | 0: 默认样式、1: 橙意会员卡样式、2:立省样式（右栏TV直播需要样式） |
| name | String | 标签名称 | 秒杀、闪购、会员日 |