wiki:appapi/1.0

Version 36 (modified by jianglindong, 10 years ago) (diff)

--

1. 图文直播APP接口1.0

备注:

1.1相关,开发环境URL前缀:  http://dev33.pcauto.com.cn:8001/

线上环境URL前缀:  http://live.pcauto.com.cn/

1.1 图文直播APP相关接口

1.1.1 登陆302中转地址

接口/intf/app/login302.jsp [GET]
说明 : 内部系统登陆302中转
请求参数 :

  
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
  
   status : 0成功,-1失败
   desc : 提示信息(如:您还没有该系统的权限)
   data:{
        userId:用户ID
        userName:用户名
    }
}

1.1.2 获取直播列表接口

接口/intf/app/getBroadcastList.jsp [get]
说明 :   只获取APP上线后的直播
请求参数 :
          pageNo:页码
          pageSize:每页数量
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
  
   pageNo:页码  
   pageSize:每页数量  
   total:总数
   data:{
            broadcastId:直播ID 
            status:状态 1直播中、2直播结束 
            thumbnail:略缩图url
            createTime:直播时间(2015-03-12 17:15:50)
            title:标题 
        }

}

1.1.3 上传直播详情接口

接口/intf/app/addRecord.jsp [POST]
说明 : 只获取APP上线后的直播
     视频id和标题可为空

请求参数 :broadcastId:直播id
           content:文字内容
           anchor:节点
           anchorDesc:节点描述
           status:状态   0正常,1发布,-1禁用,不传默认0
           imges:图片json
                               [
                                  {
                                    url:图片地址
                                   }
                                  {
                                    url:图片地址
                                   }
                                 ]
                                
            videos:视频json
                                [
                                  {
                                    id:视频id,title:标题,img:封面图地址,url:视频地址
                                   }
                                  {
                                    id:视频id,title:标题,img:封面图地址,url:视频地址
                                   }
                                 ]
                               
  
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
  
   status : 0成功,-1失败
   desc : 提示信息

}

1.1.4 更新直播发布状态接口

接口/intf/app/updateStatus.jsp [POST]
说明 :  更新直播发布状态接口
请求参数 :
          recordId:记录ID 
          status:发布状态(0未发布,1发布)
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
  
   status : 0成功,-1失败
   desc : 提示信息

}

1.1.5 获取直播简介接口

接口/intf/app/getBroadcast.jsp [get]
说明 :   只获取APP上线后的直播
请求参数 :
          broadcastId:直播id
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
             
            status : 0成功,-1失败
            desc : 提示信息
            broadcastId:直播ID 
            broadcastStatus:直播状态 1直播中、2直播结束 
            introduction:简介
            time:直播时间(2015-03-12 17:15:50)
            title:标题 
}

1.1.6 获取直播内容接口

接口/intf/app/getRecordsListById.jsp [get]
说明 :   只获取APP上线后的直播
请求参数 :
          broadcastId:直播id 
          lastTime:最后一则直播内容的时间(2016-03-24 10:19:00)
          pageNo:页码
          pageSize:每页数量
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
   status : 0成功,-1失败
   desc : 提示信息
   pageNo:页码  
   pageSize:每页数量  
   total:总数
   anchorName:主持人名字
   anchorImg:主持人头像 
   broadcastId:直播ID 
  "delRecordIds": [{"recordId": 删除直播记录id},{"recordId": 删除直播记录id}],
   records:{
            recordId:记录ID
            content:文字内容 
            creatTime:创建时间 2016-03-24 10:19 
            releaseTime:发布时间
            status:状态(-1禁用,0未发布,1发布)
            imges:图片数组 
                   [  
                      {
                       url;图片url 
                      }
                    ]
             videos:图片数组 
                   [  
                      {
                        id:视频id,title:标题,img:封面图地址,url:视频地址
                      }
                    ]
        }

}

1.1.7 上传直播详情接口

接口/intf/app/updateRecord.jsp [POST]
说明 : 增加直播详情接口
请求参数 :
           recordId:记录ID
           content:文字内容
           imges:图片json
                              [
                                  {
                                    url:图片地址
                                   }
                                  {
                                    url:图片地址
                                   }
                                ]
                                
            videos:视频json
                               [
                                  {
                                    id:视频id,title:标题,img:封面图地址,url:视频地址
                                   }
                                  {
                                    id:视频id,title:标题,img:封面图地址,url:视频地址
                                   }
                                 ]
                               
  
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
  
   status : 0成功,-1失败
   desc : 提示信息

}

1.1.8 更新直播简介接口

接口/intf/app/updateBroadcast.jsp [POST]
说明 :   只获取APP上线后的直播
请求参数 :
          broadcastId:直播id
          title:标题 
          introduction:简介
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
               status : 0成功,-1失败
               desc : 提示信息
}

1.1.9 更新直播状态接口

接口/intf/app/updateStatusForBroadcast.jsp [POST]
说明 :   只获取APP上线后的直播
请求参数 :
          broadcastId:直播id
          status:状态(1回复直播,2取消直播)
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
               status : 0成功,-1失败
               desc : 提示信息
}

1.1.10 获取直播状态接口

接口/intf/app/getBroadStatus.jsp [GET]
说明 :   获取直播状态接口
请求参数 :
          broadcastId:直播id
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
               code: 0成功,-1失败
               desc : 提示信息
               status:0(0>正常状态,1>发布状态  2>结束状态  3>隐藏状态  -1>禁用状态)
}
返回
顶部