错误代码

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

开发约束

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 获取网络剧首页推荐位数据接口
写入接口

更新说明

更新日志

Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
gif
file.gif 6.3 kB 1 09-Jul-2013 17:42 adfn111
« This page (revision-618) was last changed on 04-May-2017 17:30 by Administrator

技术文档#


API文档#

站长统计