人人网 - 开放平台wiki

请开发者在使用人人API前务必认真阅读《API使用规范及违规处理办法》。new
2011-9-9 人人网开放平台开放接口status.forward：专门用于转发状态。

人人网开放平台API提供了一种新的接口调用方式，允许被人人网用户授予权限的第三方应用以人人网用户的身份来读写人人网的资源（例如：用户基本资料、好友关系、照片等）。

[编辑] API使用规范及违规处理办法

详见《API使用规范及违规处理办法》。

[编辑] 调用API

API Server URL： https://api.renren.com/restserver.do

温馨提示：使用https协议调用API接口可以免去sig认证。

API调用基础文档

实现API调用：各种 SDK下载

[编辑] API 列表

接口分类	接口名	描述
用户信息	users.getInfo	得到用户的信息，支持批量获取。
	users.getLoggedInUser	得到当前session的用户ID。
	users.getProfileInfo	获取用户个人主页的信息。
	users.hasAppPermission	根据用户的id，以及相应在人人网的操作权限(接收email,更新状态等),来判断用户是否可以进行此操作。
	users.getVisitors	获取用户最近来访列表
	users.isAppUser	判断用户是否已对App授权。
相册	photos.upload	上传照片到用户的相册。
	photos.getAlbums	获取用户的相册列表。
	photos.get	获取单个相册的照片列表或某张照片的信息。
	photos.createAlbum	创建新的相册。
	photos.getComments	获取可见照片的相关评论内容。
	photos.addComment	对可见照片或者相册进行评论。
	photos.tag	以session_key对应用户的身份圈出照片中的好友或人，此API会发送圈人请求，待用户接受圈人请求后会发出圈人新鲜事。
	photos.getTags	以session_key对应用户的身份获取照片中圈出的好友或人。
	photos.acceptTag	接受圈人请求，此API会触发一个圈人新鲜事。
	photos.refuseTag	拒绝接受圈人请求，此API会删除圈人请求。
好友关系	friends.getFriends	得到当前登录用户的好友列表。
	friends.getAppFriends	查询当前用户安装某个应用的好友列表，此接口返回全部数据（2008-12-18）。
	friends.get	得到当前登录用户的好友列表，得到的只是含有好友id的列表。
	friends.areFriends	判断两组用户是否互为好友关系，比较的两组用户数必须相等。
	friends.search	搜索用户，根据搜索条件返回搜索结果。
	friends.getSameFriends	获取两个用户的共同好友。
	friends.getAppUsers	返回已经添加了一个应用的好友的用户Id列表,已经过期，不推荐使用，请使用friends.getAppFriends。
状态	status.set	用户更新状态。
	status.gets	获取用户的状态列表。
	status.getComment	获取一条状态中的所有回复内容。
	status.addComment	对一条状态增加一条回复。
	status.get	返回用户某条状态。
	status.getEmoticons	获取状态中的表情图片和表情符号对应列表。
	status.forward	用户转发状态的操作，支持同时评论给转发人。
新鲜事	feed.publishFeed	发布用户的个人动态信息到用户人人网主页，同时会出现在好友的新鲜事中。 (此接口区别于老的feed.publish,它不需要注册新鲜事模版，且自带回复框)。
新鲜事	feed.get	获取新鲜事，可指定新鲜事的类型。
分享
	share.share	发布分享，例如分享视频、音乐、链接、日志、商品、照片等。 (此接口是share.publish接口的升级，支持二次分享，且返回分享Id，分享url等更多信息)。
	share.getComments	以Session Key对应的用户的身份获取某个分享的评论。
	share.addComment	以Session Key对应的用户的身份对某个分享进行评论。
通知	notifications.send	给指定的用户发送通知。
日志	blog.gets	获取指定用户的可见日志列表。
	blog.get	获取自己或好友一篇日志的全部信息。
	blog.getComments	获取一篇日志的评论。
	blog.addBlog	发表一篇日志。
	blog.addComment	对日志评论。
公共主页	pages.isFan	判断用户是否为Page（公共主页）的粉丝。
	pages.getInfo	获取某个Page的信息。
	pages.getList	获取Page的列表。
	pages.isPage	判断一个ID是否为PAGE。
	pages.getFansList	获取Page粉丝的列表。
	pages.getManagedList	获取当前用户管理的Page列表。
	pages.setStatus	Page管理员修改Page的状态。
	pages.isAdmin	判断用户是否为Page的管理员。
	pages.getCategories	获取Page类别。
公共主页UGC管理	Page APIs	用于管理公共主页日志、状态、照片、更重评论等一系列API。
支付	pay.regOrder	预存入用户在应用中消费产生的订单数据，消费金额等信息，返回保证一个用户某次在一个应用中支付人人豆安全性的Token（2008-10-27）。
	pay.isCompleted	查询某个用户在一个应用中一次消费是否完成（2008-10-27）。
	pay.queryOrders	查询订单状态。
	pay4Test.regOrder	只用于开发者模拟人人豆支付的测试，功能与pay.regOrder一样（2008-12-18）。
	pay4Test.isCompleted	只用于开发者模拟人人豆支付的测试，功能与pay.isCompleted一样（2008-12-18）。
管理	admin.getAllocation	得到一个应用当天可以发送的通知和邀请的配额。
管理	admin.textFilter	对给定的文本进行过滤，返回过滤后的文本，如果不合法，则给出错误信息。
喜欢	like.isLiked	判断用户是否喜欢过url。
	like.like	针对某个url执行like操作(可以是站内资源url，如：日志、照片、相册、视频等。也可以是站外的资源url)。
	like.getCount	获取url被喜欢的次数。
	like.unlike	针对某个url执行取消like操作(可以是站内资源url，如：日志、照片、相册、视频等，也可以是站外的资源url)。
邀请	invitations.getInfo	根据用户ID或者时间段，获得邀请的详细信息（邀请人、邀请时间、被邀请人）。
邀请	invitations.createLink	创建站外邀请的链接地址。
地理位置信息(LBS)	places.create	创建一个地点。
地理位置信息(LBS)	checkins.checkin	签到。
请求	requests.getTagRequests	获取用户的圈人请求列表。

接口分类	接口名	描述
已作废接口	notifications.sendEmail	在取得用户的授权后，给用户发送Email。
	feed.publishTemplatizedAction	发送自定义格式的新鲜事（news-feed、mini-feed）,如果需要发送新鲜事请参考自定义新鲜事。
	invitations.getUserOsInviteCnt	得到某个用户站外邀请的详细信息（发送邀请信数、星级用户数等）。
	invitations.getIsInviters	根据用户的id获得想该用户发送过的站内邀请的好友id。用户id可多个,以,号分隔，返回的<inviter_id >节点的id按发送邀请的先后排序。
	users.isAppAdded	判断用户（当前会话用户或者是一个指定ID的用户）是否已经添加了该应用。请使用users.isAppUser来替代。
	invitations.getOsInfo	根据站外邀请id得到此次邀请的详细信息（邀请人、邀请时间、被邀请人、注安装app时间等）。
	connect.getUnconnectedFriendsCount	此方法返回当前用户在此站点上，但还没有建立connect关系的好友数量。
	connect.registerUsers	用来建立站点用户和校内用户之间的映射关系。
	connect.unregisterUsers	删除站点用户和校内用户之间的映射关系。