/wiki/User:10.7.18.80 登录/创建账户 

从2013年9月1日起API 1.0不再支持新申请APP的接入,新接入APP请使用API 2.0! 地址
针对API2.0暂时不支持的支付、Page的接口,还是继续使用API1.0


API接口已经全面升级到API2.0,建议开发者尽快升级,详情请浏览《API2.0升级攻略》new
请开发者在使用人人API前务必认真阅读《API使用规范及违规处理办法》

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

目录

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

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

[编辑] 调用API


API Server URL: https://api.renren.com/restserver.doImage:New.gif

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

API调用基础文档

实现API调用:各种 SDK下载

[编辑] API 列表


接口分类 接口名 描述
用户信息 users.getInfo 得到用户的信息,支持批量获取。 Image:Common.gif
users.getLoggedInUser 得到当前session的用户ID。 Image:Common.gif
users.getProfileInfo 获取用户个人主页的信息。 Image:Common.gif
users.hasAppPermission 根据用户的id,以及相应在人人网的操作权限(接收email,更新状态等),来判断用户是否可以进行此操作。
users.getVisitors 获取用户最近来访列表
users.isAppUser 判断用户是否已对App授权。
相册 photos.upload 上传照片到用户的相册。 Image:Common.gif
photos.getAlbums 获取用户的相册列表。 Image:Common.gif
photos.get 获取单个相册的照片列表或某张照片的信息。 Image:Common.gif
photos.createAlbum 创建新的相册。
photos.getComments 获取可见照片的相关评论内容。
photos.addComment 对可见照片或者相册进行评论。
photos.tag 以session_key对应用户的身份圈出照片中的好友或人,此API会发送圈人请求,待用户接受圈人请求后会发出圈人新鲜事。
photos.getTags 以session_key对应用户的身份获取照片中圈出的好友或人。
photos.acceptTag 接受圈人请求,此API会触发一个圈人新鲜事。
photos.refuseTag 拒绝接受圈人请求,此API会删除圈人请求。
好友关系 friends.getFriends 得到当前登录用户的好友列表。 Image:Common.gif
friends.getAppFriends 查询当前用户安装某个应用的好友列表,此接口返回全部数据(2008-12-18)。Image:Common.gif
friends.get 得到当前登录用户的好友列表,得到的只是含有好友id的列表。Image:Common.gif
friends.areFriends 判断两组用户是否互为好友关系,比较的两组用户数必须相等。
friends.search 搜索用户,根据搜索条件返回搜索结果。
friends.getSameFriends 获取两个用户的共同好友。
friends.getAppUsers 返回已经添加了一个应用的好友的用户Id列表,已经过期,不推荐使用,请使用friends.getAppFriends
状态 status.set 用户更新状态。 Image:Common.gif
status.gets 获取用户的状态列表。 Image:Common.gif
status.getComment 获取一条状态中的所有回复内容。
status.addComment 对一条状态增加一条回复。
status.get 返回用户某条状态。
status.getEmoticons 获取状态中的表情图片和表情符号对应列表。
status.forward 用户转发状态的操作,支持同时评论给转发人。
新鲜事 feed.publishFeed 发布用户的个人动态信息到用户人人网主页,同时会出现在好友的新鲜事中。 Image:Common.gif
(此接口区别于老的feed.publish,它不需要注册新鲜事模版,且自带回复框)
feed.get 获取新鲜事,可指定新鲜事的类型。 Image:Common.gif
分享
share.share 发布分享,例如分享视频、音乐、链接、日志、商品、照片等。 Image:Common.gif
(此接口是share.publish接口的升级,支持二次分享,且返回分享Id,分享url等更多信息)
share.getComments 以Session Key对应的用户的身份获取某个分享的评论。
share.addComment 以Session Key对应的用户的身份对某个分享进行评论。
通知 notifications.send 给指定的用户发送通知。 Image:Common.gif
日志 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 创建一个地点。
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 删除站点用户和校内用户之间的映射关系。


[编辑] 附录



[编辑] API开放进程

[编辑] Real-Time API 服务

[编辑] 直接用access_token调用API

[编辑] API错误代码查询

[编辑] 人人网签名验证---sig参数算法

[编辑] 接口中@功能的说明

[编辑] 关于公共主页类API

[编辑] 关于API配额说明