诺云开放平台

Appearance

直播间商品菜单 ​

请求路径 ​

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

请求参数 ​

参数必选类型描述
room_id是integer直播间ID

请求示例 ​

json
{
    "room_id": 1234567890
}

注意事项

  • 该接口用于获取指定直播间的商品菜单信息
  • 横屏直播间 menu_goods_cate 返回为空
  • 竖屏直播间可直接使用 menu_goods_cate 字段

响应参数 ​

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

data 参数结构

参数必选类型描述
list是array菜单列表

list 参数结构

参数必选类型描述
id是integer菜单ID
app_id是integer直播间ID
name是string菜单名称
sort是integer排序值
create_time是string创建时间
menu_goods_cate否array橱窗（竖屏直播间有值）

menu_goods_cate 参数结构

参数必选类型描述
id是integer橱窗ID
custom_menu_id是integer菜单ID
room_id是integer直播间ID
category_name是string橱窗分组名称
sort是integer排序值

响应示例 ​

成功响应示例1：横屏直播间（单橱窗）

json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 1001,
                "app_id": 10000001,
                "name": "商品3",
                "sort": 1,
                "create_time": "2025-08-01 10:30:00",
                "menu_goods_cate": []
            },
            {
                "id": 1002,
                "app_id": 10000001,
                "name": "商品2",
                "sort": 1,
                "create_time": "2025-08-01 10:30:00",
                "menu_goods_cate": []
            }
        ]
    },
    "msg": "Success"
}

成功响应示例2：竖屏直播间（单橱窗）

json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 1001,
                "app_id": 10000001,
                "name": "菜单名称",
                "sort": 1,
                "create_time": "2025-08-01 10:30:00",
                "menu_goods_cate": []
            }
        ]
    },
    "msg": "Success"
}

成功响应示例3：竖屏直播间（多橱窗）

json
{
    "code": 200,
    "msg": "Success",
    "data": {
        "list": [
            {
                "id": 1001,
                "app_id": 10000001,
                "name": "商品菜单",
                "sort": 1,
                "create_time": "2025-08-01 10:30:00",
                "menu_goods_cate": [
                    {
                        "id": 10001,
                        "custom_menu_id": 1001,
                        "room_id": 10000001,
                        "category_name": "橱窗1",
                        "sort": 1
                    },
                    {
                        "id": 10002,
                        "custom_menu_id": 155275,
                        "room_id": 10000001,
                        "category_name": "橱窗2",
                        "sort": 2
                    },
                ]
            },
            {
            "id": 1002,
            "app_id": 10000001,
            "name": "商品菜单2",
            "sort": 1,
            "create_time": "2025-08-01 10:30:00",
            "menu_goods_cate": [
                    {
                        "id": 10001,
                        "custom_menu_id": 1002,
                        "room_id": 10000001,
                        "category_name": "橱窗3",
                        "sort": 1
                    },
                    {
                        "id": 10002,
                        "custom_menu_id": 1002,
                        "room_id": 10000001,
                        "category_name": "橱窗4",
                        "sort": 2
                    },
                ]
            }   
        ]
    }
}

错误响应示例：缺少直播间ID

json
{
    "code": 400,
    "msg": "请选择直播间",
    "data": {}
}