新版客户端和服务端接口文档(张亮).docVIP

前言 Verion 3.0 Author 张亮 Changelog 2011-08-26 增加产品文档VO.4版的接口文档 名称解释： 客户端：为各种硬件商开发的酷六视频播放软件 服务端：为客户端提供各种数据的模块 wapinfo,主要处理获取各种视频数据 视频类型ctype：目前支持5中类型格式的视频，客户端须根据需要选择自己支持的类型 名称 描述 类型 后缀 ipad_mp4 mp4 9 mp4 mp4 UCWEB专用 8 mp4 mp4 高清 2 mp4 3gp Q屏 7 3gp 3gp 流畅 4 3gp flv 塞班专用 10 mp4 注意事项： 给ipad的图片支持通过ctype=10来识别 客户端版本定义图(重要) 接口规范 所有的接口请求均为GET方法例如http:// 37:8088/wapForClient.htm?name1=value1name2=value2name3=value3 所有的新的请求接口中，必须带参数ct 37:8088为开发阶段测试服务器, 上线时将切换至域名. 苹果客户端的值为iphone,ipad 塞班客户端的值为symbian 安致客户端的值为android 参数说明中“必须要有”标识的一定得有，没有标识的可有可无 响应 绝大多数响应均以XML格式返回例如?xml version=1.0 encoding=utf-8? wapi…/wapi 注意事项： 根据不同的接口，可能wapi的都有变化。wapi的子节点为： resultFAULT/result text![CDATA[ 错误信息 ]]/text 返回的xml结构中，有关video节点的全部统一为下面的格式： videos //视频总数count50/count video //视频ID videoid123/videoid //标题 title郭美美写真/title //原预览图,注意标签 picurl /200911/10/0/9690215125016337/3.jpg/ picurl //用户ID(所有者) uid3114224/uid //视频长度单位秒 length158/length //视频大小 size2984577/size //播放地址 playurl /video.htm?method=playctype=7segnum=1vidubtype=1stype=rtsp /playurl //上传时间 uploaddate2009-11-10 14:30:15/uploaddate //频道ID channelId6/channelId //频道名称 channelName娱乐频道/channelName //视频编码格式，详见视频格式定义 encodetype7/encodetype //评分（0-5） grade4/grade //视频描述 description郭美美成长历程/description //评分 score4/score //转发次数 forwardnum9/forwardnum /video video……/video /videos 返回的视频列表的xml定义如下： wapi videos //视频总数count50/count video…/video video…/video … /videos /response /wapi 5.分页参数p的最小值为1 接口明细地址 clientRequestV2.htm 样例 37:8088/wapinfo2.0/clientRequestV2.htm?method=getFocusPicturectype=10ct=symbian 参数 名称 说明 string 其值为getFocusPicture 必须要有 ct 客户端的类型 必须要有 ctype int 视频类型定义 4: 3gp 流畅 7: 3gp Q屏 2: mp4 高清 8: mp4 UCWEB专用 9: ipad_mp4 mp4 10: flv flv 必须要有 返回xml样例： ?xml version=1.0 encoding=UTF-8? wapi pic descrition111111111/descrition titletitle1/title picid11111/picid picurl /0/woman/62/18mmcom79.jpg /picurl /pic pic/pic /wapi 获取栏目列表 地址 lientRequestV2.htm 样例 37:8088/wapinfo2.0/clientRequestV2.htm?method=getR