文档中心 > API类目 > 淘宝直播API

taobao.live.room.create (直播间创建接口)

直播间创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
main_account_id Number 必须 100 主账号id
user_id Number 必须 100 用户id
room_num Number 必须 160560 房间号
landscape String 必须 false 横竖屏
title String 必须 12123 标题
cover_img String 必须 https://gw.alicnd.com/xxx 封面图
live_channel_id Number 必须 15 栏目
appointment_time Number 必须 1648014702822 预约开始时间
live_end_time Number 必须 1648029102822 结束时间
location String 必须 在火星 位置
longitude String 可选 120.298501 经度
latitude String 可选 30.41875 纬度
ext_param String 可选 "{\"couldSubscribeGoods\":true,}" 扩展属性
app_id String 可选 0 appId
live_column_id Number 必须 88 栏目
room_type Number 必须 1025 直播间类型
code_level Number 可选 0
  • 默认值:0
  • 编码等级
    video_id String 可选 1 视频ID
    video_cover_url String 可选 http://xxx 视频封面
    video_cover_height Number 可选 1920 视频封面高
    video_cover_width Number 可选 1280 视频封面宽
    desc_info String 可选 abcd 简介
    cover_img_169 String 可选 https://gw.alicnd.com/xxx 直播16:9封面图

    响应参数

    名称 类型 示例值 描述
    msg_code String 100 错误码
    msg_info String 成功 错误信息
    model String {"liveId":352401169394} 返回值

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    LiveRoomCreateRequest req = new LiveRoomCreateRequest();
    req.setMainAccountId(100L);
    req.setUserId(100L);
    req.setRoomNum(160560L);
    req.setLandscape("false");
    req.setTitle("12123");
    req.setCoverImg("https://gw.alicnd.com/xxx");
    req.setLiveChannelId(15L);
    req.setAppointmentTime(1648014702822L);
    req.setLiveEndTime(1648029102822L);
    req.setLocation("在火星");
    req.setLongitude("120.298501");
    req.setLatitude("30.41875");
    req.setExtParam("\"{\\"couldSubscribeGoods\\":true,}\"");
    req.setAppId("0");
    req.setLiveColumnId(88L);
    req.setRoomType(1025L);
    req.setCodeLevel(0L);
    req.setVideoId("1");
    req.setVideoCoverUrl("http://xxx");
    req.setVideoCoverHeight(1920L);
    req.setVideoCoverWidth(1280L);
    req.setDescInfo("abcd");
    req.setCoverImg169("https://gw.alicnd.com/xxx");
    LiveRoomCreateResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <live_room_create_response>
        <msg_code>100</msg_code>
        <msg_info>成功</msg_info>
        <model>{&quot;liveId&quot;:352401169394}</model>
    </live_room_create_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

    返回
    顶部