API2

跳转至: 导航搜索

English version for API2

目录

简介

API2.0是对原人人API的一次全面的升级,新版接口旨在更好的满足开发者的需求,提供功能上更丰富、使用上更高效、文档上更规范、管理上更可控的接口。

注意:原来的API1.0服务将不再维护,预计在年底(2013)前关闭。
如果要访问API1.0的接口请访问 http://wiki.dev.renren.com/wiki/API

API2.0的新特点

  1. 1.功能更丰富
    • 虽然本次升级(一期)只是覆盖了人人网最核心的用户资源相关的接口,如UGC(状态、日志、分享、相册、照片),用户(资料信息、profile信息、好友信息)、新鲜事、通知等,但是其中很多接口会开放更多的用户资源,如用户资料就开放了许多API1.0中无法获取的信息,开发者将获取更加丰富的数据;
    • API2.0将支持OAuth2.0中Bearer Token和MAC Token的两种token形式,其中MAC Token是一种不过期的Token,它会让开发者不再去关心Token过期的问题,极大的降低开发难度,另外,API2.0将支持客户端凭证授权流程,为开发者提供更多的选择。具体验证授权新特征的详见验证授权
  2. 2.使用更高效
    • 新的API框架中,对返回的数据做了巧妙的设计,在定义数据结构的时候做了必须和可选的区分,对于可选的部分如果为空,则不会被放入返回数据中,减少冗余的数据,节约带宽;
    • 在产生UGC类的接口(如发布状态、写日志,上传照片,添加评论等)的设计上也做了改进,不再像以前一样只是简单的返回是否发布成功或者产生的UGC的一个Id,而是将产生的UGC的详细的内容返回给调用者,无需再调用获取接口,降低开发复杂度。
  3. 3.定义更规范
    • 根据对资源的CRUD,区分POST和GET请求;
    • 接口名称全部采用“/资源名称[/分组名称/]操作名称”的格式;
    • 对于某一类接口,也就是接口名称以相同的“/资源名称”开头的接口,返回数据是统一的,都是该资源的类型,并且所有的资源类型都是标准化的,保证不同接口中返回数据的一致性。
  4. 4.管理更可控
    • 依旧会按不同的授权级别对接口的调用的进行配额限制,详细情况见配额说明
    • 后续会提供接口调用统计后台供开发者查询,请广大开发者持续关注。

API 2.0 列表

接口分类 接口名 描述
location /v2/location/feed/list 通过经纬度获取新鲜事。
/v2/location/get 根据经纬度定位地点。
album /v2/album/list 以分页的方式获取某个用户的相册列表
/v2/album/get 获取某个用户的某个相册
/v2/album/put 创建一个相册
blog /v2/blog/list 以分页的方式获取某个用户的日志列表
/v2/blog/put 创建一篇日志
/v2/blog/get 获取某个用户的某篇日志
vipinfo /v2/vipinfo/get 获取某个用户的VIP信息
evaluation /v2/evaluation/reply/put 回复点评
/v2/evaluation/reply/list 签到回复列表
/v2/evaluation/put 用户发表点评
share /v2/share/ugc/put 分享人人网内部UGC资源,例如:日志、照片、相册、分享(基于已有分享再次进行分享)
/v2/share/hot/list 获取人人推荐资源
/v2/share/url/put 分享人人网外部资源,例如:视频、图片等
如果要分享一张本地照片到人人网(即上传),建议使用/v2/photo/upload接口
/v2/share/get 获取某个用户的某个分享
/v2/share/list 以分页的方式获取某个用户的分享列表
/v2/share/count/get 获取站内UGC分享数及浏览数
/V2/share/url/count/get 获取视频、链接等源地址分享数及浏览数
ubb /v2/ubb/list 获取人人网ubb列表
notification /v2/notification/user/put 以用户身份向用户发送通知
/v2/notification/app/put 以应用身份向用户发送通知
feed /v2/feed/put 发送自定义新鲜事。新鲜事会发布用户的个人动态信息到用户人人网主页,
同时会出现在好友的新鲜事中。
/v2/feed/list 根据新鲜事类型获取新鲜事列表
place /v2/place/friend/feed/list 获取自己和好友的带lbs信息的feed列表
/v2/place/put 创建地点
/v2/place/feed/list 通过地点获取新鲜事。
/v2/place/list 根据经纬度获取地点列表。
profile /v2/profile/get 获取用户的主页信息,包括各种统计数据。
app /v2/app/get 获取某个应用的信息,部分信息取自缓存,不能立即生效
status /v2/status/get 获取用户状态
/v2/status/put 更新用户状态
/v2/status/list 获取用户状态列表
/v2/status/share 分享用户状态
like /v2/like/ugc/remove 取消对站内资源的赞。
/v2/like/ugc/put 赞人人内部资源,相册、照片、日志、分享、视频等。
/v2/like/ugc/info/get 获取站内资源被赞的次数。
photo /v2/photo/upload 上传照片至用户相册。此接口需要采用multipart/form-data的编码方式。
/v2/photo/get 获取某个用户某个相册里的某张照片
/v2/photo/list 以分页的方式获取某个用户某个相册里的照片列表
checkin /v2/checkin/reply/list 签到回复列表
/v2/checkin/put 用户进行签到
/v2/checkin/get 获取签到信息
/v2/checkin/list 获取签到列表
/v2/checkin/reply/put 签到回复
comment /v2/comment/put 对某个对象(日志、状态、照片、相册、分享等)进行评论
/v2/comment/list 以分页的方式获取某个UGC的评论
user /v2/user/batch 批量获取用户信息
/v2/user/get 获取用户信息
/v2/user/friend/list 获取某个用户的好友列表
/v2/user/friend/uninstall/list 获取当前登录用户未安装某应用里的好友列表
/v2/user/friend/mutual/list 以分页的方式获取某个用户与当前登录用户的共同好友
/v2/user/friend/app/list 获取当前登录用户在某个应用里的好友列表
/v2/user/login/get 获取当前登录用户信息
friend /v2/friend/list 获取某个用户的好友ID列表
page /v2/page/isfan 判断用户是否为某个公共主页的粉丝
/v2/page/user/list 获取用户关注的所有公共主页信息列表
/v2/page/list 获取人人网所有公共主页信息列表
/v2/page/get 获取指定id公共主页信息

如何升级到API2.0

API使用的基本流程都没有改变,只需要开发者将应用中使用的API1.0接口对应迁移到API2.0接口就可以,此过程中需要根据新接口的调用地址、调用方式、参数、返回值、错误信息处理来进行代码的改造。

为了方便开发者迁移和升级,开放平台为开发者提供了各种版本SDK,目前包括java、php、c++和ios版本,SDK的相关情况见SDK列表。另外,强烈推荐一下上面内容中提到的API2.0新特征中的MAC Token,这是一降低开发难度的非常好的一种方式,在开放平台提供的SDK中,默认采用的也是这种Token形式,详见MAC Token介绍

API2.0 SDK列表

开放平台目前开放的SDK的平台版本如下,我们强烈建议开发者使用SDK来调用人人API2.0接口功能!

版本 说明 查看源码 版本
java java_sdk相关说明 查看源码 0.9.0
php php_sdk相关说明 查看源码 0.9.0
.net .net_sdk相关说明 下载SDK 0.9.0
ios ios_sdk相关说明

SDK下载

0.9.3
android android_sdk相关说明 下载SDK 0.9.3
ios分享组件 ios分享组件sdk相关说明 下载sdk及demo 0.9.3
android分享组件 android分享组件sdk相关说明 下载sdk及demo 0.9.3

API2.0 配额说明

详情请参考API2.0配额说明