诺云开放平台

Appearance

直播间菜单商品列表 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/Room/getRoomMenuGoods/2.0.0
  • 频率限制：10秒100次

请求参数 ​

参数必选类型描述
room_id是integer直播间ID
uid是integer用户ID
custom_menu_id是integer菜单ID
page是integer第几页（最小值1）
page_size是integer一页显示多少（最小值1，最大值100）
keyword否string搜索关键词
custom_menu_goods_category_id否integer竖屏直播间橱窗字段ID（没有传0）

请求示例 ​

示例1：获取直播间菜单商品列表

json
{
    "room_id": 100001,
    "uid": 10001,
    "custom_menu_id": 1001,
    "custom_menu_goods_category_id": 100,
    "page": 1,
    "page_size": 15
}

示例2：搜索指定关键词的商品

json
{
    "room_id": 100001,
    "uid": 10001,
    "custom_menu_id": 1001,
    "custom_menu_goods_category_id": 0,
    "keyword": "手机",
    "page": 1,
    "page_size": 20
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object商品数据

data 参数结构

参数必选类型描述
total是integer商品总量
list是array商品列表

list 参数结构

参数必选类型描述
id是integer商品ID
img是string商品图片
name是string商品名称
unit是string商品单位
is_sku是integer是否SKU商品 1：是 2：否
price是string商品价格
lowest_price是string砍价 - 商品底价
underlined_price是string划线价
stock是integer库存
custom_menu_id是integer菜单ID
recommend是integer推荐商品 1：是
explain是integer讲解商品 1：是 2：否
heat_num是integer商品讲解热度
is_display_stock是integer显示状态 1:显示；2：隐藏
welfare_activity_id是integer福利购活动id
is_to_store_discount是integer1:到店折扣，2：不是到店折扣
to_store_discount_content是string到店折扣内容
is_coupon_type是integer1:优惠券商品 2：不是优惠券商品
is_show_room是integer是否在直播间显示 1显示 2隐藏
sale_type是integer开售类型 1--立即开售 2--定时开售
sale_time是integer立即开售时间（时间戳）
sale_time_date是string立即开售时间
sale_status是integer销售状态 1：关闭 2：开启
seckill是integer秒杀状态。1：关闭；2：开启
seckill_conf否object秒杀配置信息
linkType是string购买方式(text文字链接，pic图片链接，local本地购买，applet小程序购买)
link是string购买方式链接
linkPicPath是string购买方式链接（图片）
applet_buy_conf_link是string链接 小程序购买
applet_buy_conf_original_id是string原始id 小程序购买
applet_buy_conf_appid是stringappid 小程序购买
storage是integer库存
groupon_info否object拼团活动信息
bargain_activity_info否object砍价活动信息
is_subject是integer是否是知识付费 1 是 2 不是
type是string商品类型。goods:实体商品，virtual:虚拟商品
sort是integer排序
selling_point是string商品卖点
goods_watch_status是integer商品直播看点状态 1：正常 2：失效
goods_watch_id是integer商品直播看点id
goods_watch_expire是string商品直播看点失效时间

seckill_conf 参数结构

参数必选类型描述
start_time是integer秒杀开始时间
end_time是string秒杀结束时间
start_timestamp是integer秒杀开始时间（时间戳）
end_timestamp是integer秒杀结束时间（时间戳）
total_stock是integer秒杀库存
price是string秒杀价格

groupon_info 参数结构

参数必选类型描述
people_number是integer团购人数
lowest_price是string最低价格
end_time是string结束时间

bargain_activity_info 参数结构

参数必选类型描述
status是integer2-未开始，3-进行中，4-已结束
lowest_price是string底价
end_time是string结束时间

响应示例 ​

成功响应示例

json
{
    "code": 200,
    "data": {
        "total": 2,
        "list": [
            {
                "id": 10001,
                "img": "https://example.com/images/product1.jpg",
                "name": "示例商品1",
                "unit": "个",
                "is_sku": 2,
                "price": "99.00",
                "lowest_price": "89.00",
                "underlined_price": "129.00",
                "stock": 100,
                "custom_menu_id": 1001,
                "recommend": 1,
                "explain": 1,
                "heat_num": 50,
                "is_display_stock": 1,
                "welfare_activity_id": 0,
                "is_to_store_discount": 1,
                "to_store_discount_content": "{\"type\":\"4\",\"original_price\":129,\"front_money\":99}",
                "is_coupon_type": 2,
                "is_show_room": 1,
                "sale_type": 1,
                "sale_time": 0,
                "sale_time_date": "",
                "sale_status": 2,
                "seckill": 1,
                "linkType": "local",
                "link": "",
                "linkPicPath": "",
                "applet_buy_conf_link": "",
                "applet_buy_conf_original_id": "",
                "applet_buy_conf_appid": "",
                "storage": 100,
                "seckill_conf": {},
                "groupon_info": {},
                "bargain_activity_info": {},
                "is_subject": 2,
                "type": "goods",
                "sort": 1,
                "selling_point": "优质商品，值得购买",
                "goods_watch_status": 1,
                "goods_watch_id": 1001,
                "goods_watch_expire": ""
            },
            {
                "id": 10002,
                "img": "https://example.com/images/product2.jpg",
                "name": "示例商品2",
                "unit": "件",
                "is_sku": 2,
                "price": "199.00",
                "lowest_price": "179.00",
                "underlined_price": "259.00",
                "stock": 50,
                "custom_menu_id": 1001,
                "recommend": 0,
                "explain": 2,
                "heat_num": 30,
                "is_display_stock": 1,
                "welfare_activity_id": 0,
                "is_to_store_discount": 2,
                "to_store_discount_content": "",
                "is_coupon_type": 2,
                "is_show_room": 1,
                "sale_type": 1,
                "sale_time": 0,
                "sale_time_date": "",
                "sale_status": 2,
                "seckill": 1,
                "linkType": "local",
                "link": "",
                "linkPicPath": "",
                "applet_buy_conf_link": "",
                "applet_buy_conf_original_id": "",
                "applet_buy_conf_appid": "",
                "storage": 50,
                "seckill_conf": {},
                "groupon_info": {},
                "bargain_activity_info": {},
                "is_subject": 2,
                "type": "virtual",
                "sort": 2,
                "selling_point": "热销商品，限时优惠",
                "goods_watch_status": 1,
                "goods_watch_id": 1002,
                "goods_watch_expire": ""
            }
        ]
    },
    "msg": "Success"
}

搜索无结果示例

json
{
    "code": 200,
    "msg": "Success",
    "data": {
        "total": 0,
        "list": []
    }
}