错误代码

关于错误返回值与错误代码,参见 错误代码说明

开发约束

GET和POST中参数值有中文的,要先urlencode为utf-8编码,然后再请求
json返回的数据中对空的统一处理
字符串"",数字0,对象null
用户头像需要客户端自行根据规格进行请求
如:
http://img01.cucimg.com/M00/26/B4/cR9ARk9ikNyjHEqBAABxabl2HFs537.jpg
=>
http://img01.cucimg.com/M00/26/B4/cR9ARk9ikNyjHEqBAABxabl2HFs537_120X90.jpg
测试api域名是test.api.cuctv.com,测试graph域名是test.graph.cuctv.com
用户之间的关注关系需要通过单独的接口请求返回
微博9秒拍类型的图片规格attachSImg是不带规格的原图,attachBImg是带_440X4000.jpg的大图

授权

读取接口
写入接口
oauth2/authorize Web应用的验证授权(Authorization Code)
oauth2/access_token 获取授权Access Token
oauth2/user_create 手机用户注册并授权
oauth2/user_quick_create 手机用户快捷注册授权
oauth2/user_quick_create2 手机或Email用户快捷注册授权
oauth2/end_session 手机用户退出登录

微博

读取接口
statuses/follower 获取关注用户的最新微博列表
statuses/show 通过id获取微博
statuses/gets 通过一组id批量获取微博
statuses/mentions 获取提到我的微博
statuses/trends 获取话题微博
statuses/user_timeline 获取个人微博
statuses/public_timeline 随便看看
statuses/repost/top 获取最热转发
statuses/4/1/top 获取最热评论微博列表
statuses/live/nowlist 获取正在直播微博列表(请求的个数如果不满足则从NEWLIST中获取补足)
statuses/search 搜索微博
statuses/4/1/search.json 高级搜索微博
statuses/share_video 分享视频列表
statuses/recommend_pai 编辑推荐热门九秒拍微博列表
statuses/4/1/repostlist 获取微博的转发微博列表
statuses/4/1/recommend_9spai 获取编辑推荐9秒拍微博列表
写入接口
statuses/update 发微博(支持发布九秒拍微博)
statuses/repost 转发一条微薄
statuses/session/create 发起对话
statuses/destroy 删除微博信息
statuses/upload 上传图片并发布一条微博
statuses/settop 置顶一条微博(包括取消置顶)
statuses/setlike 赞一条微博
statuses/cancellike 取消赞一条微博

直播

读取接口

live/share 获取我分享的直播列表
live/user_timeline 获取用户直播列表
live/official_timeline 获取App官方的直播列表

live/top_play 获取当天最热直播列表

live/top_comment 获取直播评论列表

live/live_search 搜索直播视频

live/live_trends 获取直播话题微博

live/follower 获取关注用户的最新直播列表
4/live/1/nowlist 正在直播列表

4/live/1/show 通过直播ID获取一个直播视频信息

4/live/1/2/private_group 获取私密直播用户分组
4/live/1/2/private_group_list 获取私密直播用户分组(附带部分用户信息)
4/live/1/2/private_group_users 获取所属某个私密直播用户分组的用户列表
4/live/1/2/play_file 获取获取私密直播viewkey方法
4/live/play 播放直播接口兼容播放私密直播(老版本调用)
4/live/1/2/get_watch_privatelive_users 获取正在观看某私密直播的用户列表
4/live/1/2/is_subscribe微直播是否订阅
4/live/1/2/subscribes 所有订阅微直播列表
4/live/1/2/show_private_liveinfo 获取私密直播分组用户和分组
4/live/1/2/nowlist 新版正在直播列表
4/live/1/2/follower 新版好友圈直播列表

写入接口
live/create 发直播
live/stop 停止直播 老平台的视频微博调用,废弃

4/live/create 发表直播
4/live/1/2/destroy 根据一个直播ID删除直播
4/live/1/2/private_create 发表私密直播
4/live/update 更新直播
4/live/1/2/update 更新直播(更新部分信息)

4/live/1/live_share 分享直播 并发布一条微博

4/live/1/create_comment 评论直播

4/live/1/reply_comment 回复一个直播的评论
4/live/1/2/create_private_group 创建私密直播用户分组
4/live/1/2/update_private_group 修改私密直播用户分组
4/live/1/2/destroy_private_group 删除私密直播用户分组
4/live/1/2/private_group_adduser 向指定私密直播分组添加用户
4/live/1/2/private_group_deluser 从指定私密直播分组中删除用户
4/live/1/2/private_group_updateuser 更新指定私密直播分组用户
4/live/1/2/play/add 直播播放次数+1
4/live/1/2/pause 直播暂停(不调用)
4/live/1/2/finish 直播结束

4/live/1/2/add_subscribe 订阅直播(微直播)
4/live/1/2/del_subscribe 取消订阅直播(微直播)
4/live/1/2/publish 发布微直播(废弃)

4/live/play/add 播放次数+1
4/live/1/2/modify_private_liveinfo 更新私密直播分组用户和分组

网络直播

读取接口
4/live/1/shownetlive 通过网络直播ID获取一个网络直播视频信息
4/live/1/isfavoritenetlive 判断网络直播是否被收藏
4/live/1/favoritenetlivelist 获取收藏的网络直播列表
netlive/netlive_search 搜索网络直播
netlive/netlive_search2 搜索直播(微直播+网络直播)
netlive/netlive_getnetlivelistbytype 通过类型获取网络直播列表

netlive/netlive_issubscribe 判断网络直播是否订阅
netlive/netlive_getsubscribelist 获取网络直播订阅列表
netlive/netlive_getxynetlivebystatus 根据时间查询直播预告或直播列表
netlive/netlive_getxynetlivebyuniversity 根据学校查询直播预告或直播列表
netlive/netlive_getxynetlivebyuniname 根据学校名称查询直播预告或直播列表
netlive/netlive_getnetlivelistbytag 根根据标签获取网络直播列表
netlive/4/1/play_heartbeat 网络直播播放心跳接口
netlive/4/1/stop_heartbeat 停止网络直播播放心跳口
netlive/4/1/check_watch_pwd 校验观看码是否正确
netlive/4/1/get_votepaid_list 网络直播参与投票的用户列表

写入接口
4/live/1/netlivefavorite 网络直播收藏
4/live/1/delnetlivefavorite 取消网络直播收藏
4/live/1/netlivehits 网络直播点击+1/获取点击数(老版本调用)
4/live/1/netlivedigs 网络直播顶+1/获取顶数
4/live/1/netlive/cancle_digs 网络直播取消顶
4/live/1/netlivestamps 网络直播踩+1/获取踩数
4/live/1/create_netlivecomment 评论网络直播
netlive/netlive_addusersubscribe 订阅网络直播
netlive/netlive_delusersubscribe 取消订阅网络直播
netlive/4/1/play/add 播放次数+1
netlive/4/1/fresh_line 获取网络直播最新线路信息

涂鸦

读取接口
graffities/timeline 获取涂鸦信息
写入接口
graffities/create 分享涂鸦

评论

读取接口

comments 获取微博评论列表
comments/to_me 获取我收到的评论列表
comments/mentions_me 获取@我的评论列表
comments/by_me 获取我发出的评论列表
comments/my 我发出的和收到的评论列表
comments/top 获取最热评论
comments/to_video 获取视频的评论
comments/4/1/to_live 获取直播的评论
comments/4/2/to_live 获取直播的评论(新版api设计)
comments/4/2/to_video 获取点播视频的评论(新版api设计)
comments/4/1/to_netlive 获取网络直播的评论(废弃)
comments/live/tome 获取已收到的直播的评论列表

comments/live/byme 获取已发出的直播的评论列表
comments/user_all_lives获取发出的所有直播(微直播或网络直播)评论列表
comments/to_user_all_lives获取收到的所有直播(微直播或网络直播)评论列表
comments/4/1/2/to_live获取直播收到评论列表(微直播或网络直播,支持游标)
comments/4/1/get_comment_total_by_id获取直播收到评论总数(微直播或网络直播,或视频,支持游标)
comments/4/1/get_comment_by_id获取直播收到评论列表(微直播或网络直播,或视频,支持游标)

写入接口
comments/create 评论一条微博
comments/destroy 删除一条评论

comments/video/destroy 删除一条视频的评论
comments/4/1/live/destroy 删除一条直播的评论
comments/reply 回复一条评论
(仅作兼容,调用请使用下方的4.1版本接口)
comments/4/1/reply 回复一条微博的评论(支持同时转发)

关系

读取接口
friendships/4/1/mutual 获取互相关注的人
使用中friendships/friends 获取关注的人
使用中friendships/friends_zip gzip压缩获取所有关注的人
friendships/followers 获取粉丝
friendships/show 获取两个用户之间的详细关注关系
friendships/4/1/2/5/newfriends 获取新朋友
friendships/4/1/2/5/newfriendscount 获取新朋友数
写入接口
friendships/create 添加关注
friendships/create_ex 添加关注(如果已关注返回状态)
friendships/create_batch 批量添加关注
friendships/destroy 取消关注
friendships/destroy_ex 取消关注(返回相关状态)

好友分组

读取接口
friendships/groups 获取指定用户的好友分组列表
friendships/groups/members/position 获取指定用户的好友分组列表
friendships/groups/members 获取某一好友分组下的成员列表
写入接口
friendships/groups/create 增加好友分组
friendships/groups/create_batch 批量增加好友分组
friendships/groups/update 更新好友分组
friendships/groups/update_batch 批量更新好友分组
friendships/groups/destroy 删除好友分组
friendships/groups/destroy_batch 批量删除好友分组
friendships/groups/create_destroy_batch 批量增加删除好友分组(同时提交增加和删除操作)
friendships/groups/create_destroy_update_batch 批量增加删除修改好友分组(同时提交增加删除修改操作)
friendships/groups/members/add添加关注用户到指定好友分组
friendships/groups/members/update 添加已经的关注用户到指定好友分组

收藏

读取接口

favorites/user_timeline 获取个人收藏的微博

favorites/user_lives 获取个人收藏的直播列表

写入接口

favorites/create 添加收藏微博
favorites/create_ex 添加收藏微博(如果已收藏直接返回状态)
favorites/destroy 取消收藏微博
favorites/destroy_ex 取消收藏微博(返回相关状态)
favorites/is_favorited 是否为收藏微博

私信

读取接口

messages 我的私信列表
messages/4/2/zip 我的私信列表(支持语音二进制)
messages/user_timeline 我与某人的私信列表
messages/4/2/user_timeline_zip 我与某人的私信列表(支持语音二进制)
messages/4/1/user_timeline/after_id 我与某人的私信列表(获取指定ID之后的全部最新数据)
messages/4/2/user_timeline/after_id_zip 我与某人的私信列表(支持语音二进制) 写入接口
messages/create 发送私信
messages/destroy 删除私信
messages/destroy_session 删除私信会话
messages/live_create 发送直播私信
messages/live_stop 停止直播私信
messages/create/test 测试用 请勿调用

用户

读取接口
使用中user/unread_count 获取某个用户的各种消息未读数

user/show 获取用户个人信息

user/4/1/show_exinfo (废弃,请以后的新版中取相关数据勿使用该接口,数据合并到其他接口)获取用户额外信息(学校工作单位等)
user/rank 用户排行
user/pai_rank 九秒拍用户排行
user/suggestions/may_interested 获取用户可能感兴趣的人
user/search 搜索用户

user/4/1/search 按用户类型搜索用户
user/4/1/searchfollow在我关注的用户列表中搜索用户
user/exist 验证用户是否存在
user/name_exist 验证用户名是否存在
user/email_exist 验证用户邮箱是否存在

user/recommend_hot 编辑推荐用户(对应新版中的推荐关注用户)

user/recommend_schooluser 高校用户推荐
user/mobile_isvalidate是否手机验证用户

user/system_users 推送系统消息的用户列表
user/4/1/check_mobile 根据一组手机号返回对应的用户信息
user/4/1/follow_ex 获取三方平台关注用户对应我们平台的用户信息
user/4/1/findpassword_by_email 通过邮箱取回密码
user/4/1/2/thirdparty_login 三方平台用户登录
user/4/1/5/getunivtvbyregionid 根据地区获取高校电视 台列表
user/4/1/usercontactsfollows 获取用户通信录好友关系
user/4/1/get_cookies 获取登录用户cookie信息

写入接口

user/remind/clear 清空用户消息
user/update 更改用户属性
user/update_data 更改用户属性
user/create 手机用户注册
user/quick_create 手机用户快捷注册(三方快捷注册使用,内部随机一个邮箱
user/bind_create 第三方用户绑定注册
user/mobile_create 手机注册
user/update_mobile 更换手机绑定注册
user/send_mobilecode 发送手机验证码注册
user/validate_mobile 验证手机码注册

user/unbind_mobile 用户解除手机绑定
user/4/1/send_mobilecode 发送手机验证码注册
user/4/1/validate_mobile 验证手机码注册

user/4/1/mobile_create 手机注册
user/4/1/send_mobilecode_for_password 取回密码发送手机验证码
user/4/1/validate_mobile_for_password 验证密码修改验证码
user/4/1/edit_password 验证成功后修改密码
user/4/1/edit_name 修改用户名
user/4/1/upload 上传用户联系人
user/4/1/2/6/reportUserBindInfo 客户端汇报用户绑定第三方
user/4/1/2/6/modifybackground 修改用户背景图

话题

读取接口
topic/hot 获取热门话题
topic/follow 获取关注话题

topic/follow/isfollow 是否关注话题
topic/recommend_pai 获取九秒拍编辑推荐话题
topic/search 搜索话题
topic/hotrecommend 获取热门编辑推荐话题

写入接口
topic/follow/create 关注话题
topic/follow/destroy 取消关注话题

视频

读取接口

video/user_timeline 获取用户视频
video/official_timeline 获取App官方视频列表
video/new 获取最新上传视频列表
video/hot 获取最热的视频列表
video/most_comment 获取评论最多的视频列表

video/play_count 根据播放地址获取视频播放次数
video/count 根据播放地址获取视频播放次数
video/search_tag 根据标签获取视频
video/search_category 根据种类获取视频
4/video/1/search 高级搜索视频
4/video/1/2/search 高级搜索视频,注意返回的均是网络剧数据
video/recommend_hot 编辑推荐热视频
video/is_favorited 判断用户是否收藏了某视频
video/show 通过视频ID获取视频信息

video/show/by_video_url 通过视频播放地址获取一个视频信息
video/show/fileid 通过视频文件id获取一个视频信息
video/4/1/2/hits_rank_category 根据视频种类获取点击排行视频
video/4/1/5/getUnivHotVideos 获取高校热门视频
video/4/1/2/5/user_category 用户创建的视频分类
4/video/1/getwatchhistorylist 获取指定用户的观看记录

写入接口
video/create_comment 视频评论
video/share 客户端分享视频
4/video/1/video_share 分享视频(允许手工添加分享内容)
4/video/2/video9_share 分享九秒拍(允许手工添加分享内容)
video/destroy 删除视频

video/create 保存视频信息
video/update 视频信息修改
video/favorite 收藏视频
video/favorite/cancel 取消收藏视频
video/play/add 视频播放次数+1
4/video/1/addwatchhistory 增加观看足迹
4/video/1/delwatchhistory 删除观看足迹
video/reply_comment 回复一个视频的评论
视友客户端未使用 微直播调用 客户端回复视频评论使用了视频评论接口

自建频道

读取接口
channel 获取主频道列表
subchannel 获取子频道列表
datachannel 获取子频道数据

广告

读取接口
ad/timeline 获取广告列表
ad/app_timeline 获取app展示广告列表
ad/tvspecial 获取高校电视台专辑BANNER列表
写入接口

专辑

读取接口
specials 获取专辑列表
specials/video 获取专辑的视频列表
specials/user_timeline 获取用户的视频专辑列表
写入接口

系统

读取接口
system/sys_msg 获取系统通知列表
system/push_msg 获取后台推送消息
system/4/1/push_msg 获取后台推送消息
system/startup 客户端启动统计
system/4/1/square 获取广场频道
system/4/1/shorturl 获取短链接
system/4/1/cover 获取客户端封面
system/4/1/hotapp 获取热门应用推荐
system/4/1/videocategory 获取视频分类
system/4/1/9spai_back_musiclist 获取编辑推荐9秒拍背景音乐列表
system/4/1/headhotrecommend 获取客户端头部热门推荐
system/4/1/coverrecommend 获取客户端封面图片推荐
system/4/1/adcommend 客户端广告推广图推荐
system/4/1/livewaprcommend 网络直播WAP推荐
system/4/1/newlivercommend 新版微直播客户端头部推荐 by 2015.4.27
system/4/1/app_recommend 新版微直播客户端应用推荐
system/4/1/recommend_banner 首页推荐位
写入接口

标签

读取接口

tag/4/1/user_recommand 获取热门标签(9秒拍)
tag/4/1/netlivetags 获取网络直播分类列表

写入接口

读取接口
userlike/tome 获取我收到的赞列表
userlike/tostatus 获取微博收到的赞列表
写入接口

活动

读取接口
feature/getapplylist 获取用户申请的活动列表
feature/getfeatureinfo 根据活动id列表获取活动信息
feature/getmylist 获取我参加的活动列表
feature/search 搜索活动
feature/hot 热门高校活动推荐
写入接口

搜索

读取接口
search/searcchall 一次性搜索用户 微博 活动 话题
写入接口

校园

读取接口
university/getxyuniversityrank 获取校园i看高校网络直播排行
university/seracharounduniversity 根据位置信息搜索附件高校
university/getuniversitylist 获取高校列表
写入接口

支付

读取接口
pay/query_order_status 查询订单状态
pay/get_user_order_list 查询用户订单列表
pay/get_weixin_prepay_id 获取微信预付id
pay/get_ums_prepay_id 获取银联预付id
pay/get_apple_check_switch 获取客户端苹果审核开关
写入接口
pay/commit 提交获取订单号
pay/submit_report 汇报支付状态
pay/del_order 删除用户订单
pay/modify_order 修改订单号

网剧

读取接口
wangju/get_home_videos 获取网络剧首页视频数据接口
wangju/get_video_player 获取网剧视频播放器信息
wangju/get_favorite_list 获取网络剧视频收藏列表
wangju/get_relation_video 获取网络剧视频推荐列表
wangju/get_home_banner_list 获取网络剧首页推荐位数据接口
写入接口

更新说明

更新日志

添加新附件

只有授权的用户才能上传新附件。

附件列表

类型 附件名称 大小 版本 修改日期 作者 变更注释
gif
file.gif 6.3 kB 1 09-七月-2013 17:42 adfn111
« 该页面(修订版 618)最后由 Administrator 在 04-五月-2017 17:30 修改。

技术文档#


API文档#

站长统计