English version for API2

跳转至: 导航搜索

目录

Introduction

API2.0 is a complete upgrade of the original Renren API, the new interface is designed to meet the needs of developers better, to provide richer functionality, more efficient use, more standardized document management and more controllable Interface.

Note: The original API1.0 service will no longer be maintained, it is expected to be closed at the end of (2013).

API2.0 new features

  1. 1. More feature-rich
    • Although this upgrade only covers the core of all network resources associated with the user interface, such as UGC (status, logs, sharing, photo albums, photo), the user (profile information, profile information, friend information), fresh things, notifications, etc., the interface will open up many more resources to users, such as some user information that cannot get in API1.0, developers will get richer data.
    • API2.0 will support OAuth2.0 the Bearer Token and MAC Token two token form, where MAC Token is non-expire Token, it will let developers no longer take care of the problem Token expired, greatly reducing development difficulty. In addition, API2.0 will support client certificate authority processes, provides developers with more choices。Specific new features detailed in Authentication Authorization please refer toAuthentication Authorization.
  2. 2. The use of more efficient
    • New API framework, the returned data made clever design, when you define the data structure you can made optional or required, for the optional part if it is empty, it will not be placed in the returned data, reduce redundant data, save bandwidth;
    • The design of generating UGC class interface (such as release status, write blogs, upload photos, add comments, etc.) also made improvements, no longer like before, simply return success or not and the release a UGC generated Id, but UGC is now to produce detailed contents returned to the caller, no longer need to call the getting interface, reduce development complexity.
  3. 3. More standardized definitions
    • According to resources CRUD, distinguish POST and GET requests;
    • Interface name used in all "/ resource name [/ group name /] operation name" format;
    • For interfaces in a class, which is the name of the interface to the same "/ resource name" at the beginning of the interface, the return data is unified, all are in the resource type, and all resource types are standardized to ensure the Consistency of different returned interfaces data。
  4. 4. Management more controllable
    • Still will be at different levels of authority for calling the interface quota restrictions, as detailed in Quota Description;
    • We will provide an interface for developers to invoke statistical background information to inquire later, please continue to follow us.

API 2.0 List

Interface Category Interface name Description
location V2/location/feed/list Get latitude and longitude to get new feeds
V2/location/get Get location according to latitude and longitude
album /v2/album/list Use pagination way to get a user's album list
/v2/album/get Get an album of a user
/v2/album/put Create a photo album
blog /v2/blog/list Use pagination way to get a user's diary list
/v2/blog/put Create a diary
/v2/blog/get Get a diary of a user
vipinfo /v2/vipinfo/get Get information about a user's VIP
evaluation /evaluation/reply/put Reply Comments
/v2/evaluation/reply/list Registration Reply list
/v2/evaluation/put Users Write a Review
share /v2/share/talk/put IM, Send a message to the chat
/v2/share/ugc/put Share Renren internal UGC resources, such as: blogs, photos, photo albums, share (based on the existing share again sharing)
/v2/share/hot/list Get Renren Recommended Resources
/v2/share/url/put Share Renren external resources, such as: video, pictures, etc.
If you want to share a local photograph to Renren (ie, upload),Recommended /v2/photo/upload Interface
/v2/share/get Obtain a share of a user
/v2/share/list Use pagination way to get a list of users to share
ubb /v2/ubb/list Get a list of Renren network ubb
notification /v2/notification/user/put sends a notification to a user as a user
/v2/notification/app/put send a notification to the user as a application
feed /v2/feed/put Send custom new feeds. Feeds will publish the user's personal information to users dynamically Renren Home,
will also appear in the Friends’ new feeds
/v2/feed/list Get new feeds list according to new feeds type
invitation /v2/invitation/put Send invitation
place /v2/place/friend/feed/list Get your own and your friends' information with a feed list lbs
/v2/place/put Create Location
/v2/place/feed/list Get new feeds by location
/v2/place/list Get a list of locations based on latitude and longitude
profile /v2/profile/get Get the user's home information, including a variety of statistical data
app /v2/app/get Get information about an application, some information is taken from the cache, you can not take effect immediately
status /v2/status/get Get user status
/v2/status/put Update user status
/v2/status/list Get a list of user status
/v2/status/share Share User Status
like /v2/like/ugc/remove Cancel Like for resources in the station
/v2/like/ugc/put Like Renren internal resources, albums, photos, logs, sharing, video, etc.。
/v2/like/ugc/info/get Get the number of resources in the station have been like
photo /v2/photo/upload Upload photos to user gallery. This interface requires the use of multipart / form-data encoding.
/v2/photo/get Get a photo in an album of a user
/v2/photo/list Get a user’s photo list in an album by pagination way
checkin /v2/checkin/reply/list Registration Reply list
/v2/checkin/put Users to register
/v2/checkin/get Get Registration Information
/v2/checkin/list Get Registration list
/v2/checkin/reply/put Registration Reply
comment /v2/comment/put Comments to an object (log, status, photos, albums, sharing, etc.)
/v2/comment/list Use a pagination way to get a UGC comments
user /v2/user/batch Get user information in batch
/v2/user/get Get user information
/v2/user/friend/list Obtain a user's friend list
/v2/user/friend/uninstall/list Get the current logged-on user’s friend list in a does not installed application
/v2/user/friend/mutual/list Use pagination way to get a user and the user currently logged mutual friend
/v2/user/friend/app/list Get the current logged-on user’s friend list in a installed application
/v2/user/login/get Get the current logged in user information
friend /v2/friend/list Obtain a user's friend ID list

How to upgrade to API2.0

The basic processes of API uses are not changed, only the application developer has to move API1.0 interface corresponding to the interface of API2.0, this process requires a transformation of call to the new address of the interface, call, parameters, return values , the error message handling code to.

In order to facilitate the development of migration and upgrades, open platform provide a variety of versions of SDK for developers, now includes java, php, c + + and ios version, relevant circumstances SDK please see the SDK List.In addition, API2.0 new features in MAC Token is strongly recommended, which is a very good reduce of development effort that provided by open platform, the default is also used in such a Token form, please refer to MAC Token introduction.

API2.0 SDK List

Open platform’s SDK versions are as follows, we strongly recommend that developers use the SDK to call Renren API2.0 interface functions!

Version Explanation View source code Version'
java java_sdk Explanation View source code 0.9.0
php php_sdk Explanation View source code 0.9.0
.net .net_sdk Explanation Download SDK 0.9.0
ios ios_sdk Explanation Download SDK 0.9.3
android android_sdk Explanation Download SDK 0.9.3
ios Share assembly ios Share assembly sdk Explanation Download sdk and demo 0.9.3
android Share assembly sdk android Share assembly sdk Explanation Download sdk and demo 0.9.3

API2.0 Quota Description

Please refer toAPI2.0 Quota Description