內容目录

上一个主题

云直播

下一个主题

Android推流SDK使用文档

HTTP API

访问地址:http://liveapi.sinacloud.com

认证

所有的API访问都需要使用HTTP Basic进行认证。

其中,用户名为后台管理中分配的10位用户名,密码为40位。

接口列表

创建频道

GET /tube/create
  • 参数

    name: 频道名称

    description: 频道描述

成功返回新建的频道Id,失败返回相应错误信息。

删除频道

GET /tube/delete
  • 参数

    tube_id: 频道Id

成功返回code 0,失败返回相应错误信息。

更新频道信息

GET /tube/update
  • 参数

    tube_id: 频道Id

    name: 频道名称

    description: 频道描述

成功返回code 0,失败返回相应错误信息。

查询频道信息

GET /tube/query
  • 参数

    tube_id: 频道Id

成功返回频道相应的信息,失败返回相应错误信息。其中status为0表示频道关闭,为1表示开启但无信号,为2表示直播进行中。

开始直播

开始后才能推送直播流。

GET /tube/start
  • 参数

    tube_id: 频道Id

成功返回code 0,失败返回相应错误信息。

停止直播

停止后推送地址和直播地址失效。

GET /tube/stop
  • 参数

    tube_id: 频道Id

成功返回code 0,失败返回相应错误信息。

查询所有的频道信息

GET /tube/list

无参数

成功返回所有的频道信息,失败返回相应错误信息。

调用示例

curl -u username:passowrd 'http://liveapi.sinacloud.com/tube/create' -d 'name=test&despcrition=test'
{"code":0,"data":{"tube_id":"3ae472830c41148bef633d6cc80dbb2c"}}

curl -u username:passowrd 'http://liveapi.sinacloud.com/tube/query' -d 'tube_id=3ae472830c41148bef633d6cc80dbb2c'
{"code":0,"data":{"tube_id":"3ae472830c41148bef633d6cc80dbb2c","name":"test","description":null,"status":0,"publish_url":"rtmp:\/\/live2.sinacloud.com\/publish\/3ae472830c41148bef633d6cc80dbb2c","play_url":{"hls_origin":"live.sinacdn.com\/play\/3ae472830c41148bef633d6cc80dbb2c.m3u8","hls_low":"live.sinacdn.com\/play_low\/3ae472830c41148bef633d6cc80dbb2c.m3u8"}}}

curl -u username:passowrd 'http://liveapi.sinacloud.com/tube/start' -d 'tube_id=3ae472830c41148bef633d6cc80dbb2c'
{"code":0,"data":null}