HTTP API
#########

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


认证
======

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

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


接口列表
=========

创建频道
---------

.. http:get:: /tube/create

- 参数

    name: 频道名称

    description: 频道描述

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

删除频道
---------

.. http:get:: /tube/delete

- 参数

    tube_id: 频道Id

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

更新频道信息
-------------

.. http:get:: /tube/update

- 参数

    tube_id: 频道Id

    name: 频道名称

    description: 频道描述

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

查询频道信息
-------------

.. http:get:: /tube/query

- 参数

    tube_id: 频道Id

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

开始直播
----------

开始后才能推送直播流。

.. http:get:: /tube/start

- 参数

    tube_id: 频道Id

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

停止直播
---------

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

.. http:get:: /tube/stop

- 参数

    tube_id: 频道Id

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

查询所有的频道信息
--------------------

.. http:get:: /tube/list

无参数

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

调用示例
=========

.. sourcecode:: bash

   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}