人人网 api2.0 java_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. 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. 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. 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. 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

Get latitude and longitude to get new feeds

Get location according to latitude and longitude

album

Use pagination way to get a user's album list

Get an album of a user

Create a photo album

blog

Use pagination way to get a user's diary list

Create a diary

Get a diary of a user

vipinfo

Get information about a user's VIP

evaluation

Reply Comments

Users Write a Review

share

IM, Send a message to the chat

Share Renren internal UGC resources, such as: blogs, photos, photo albums, share (based on the existing share again sharing)

Get Renren Recommended Resources

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

Obtain a share of a user

Use pagination way to get a list of users to share

ubb

Get a list of Renren network ubb

notification

sends a notification to a user as a user

send a notification to the user as a application

feed

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

Get new feeds list according to new feeds type

invitation

Send invitation

place

Get your own and your friends' information with a feed list lbs

Create Location

Get new feeds by location

Get a list of locations based on latitude and longitude

profile

Get the user's home information, including a variety of statistical data

app

Get information about an application, some information is taken from the cache, you can not take effect immediately

status

Get user status

Update user status

Get a list of user status

Share User Status

like

Cancel Like for resources in the station

Like Renren internal resources, albums, photos, logs, sharing, video, etc.。

Get the number of resources in the station have been like

photo

Upload photos to user gallery. This interface requires the use of multipart / form-data encoding.

Get a photo in an album of a user

Get a user’s photo list in an album by pagination way

checkin

Registration Reply list

Users to register

Get Registration Information

Get Registration list

comment

Comments to an object (log, status, photos, albums, sharing, etc.)

Use a pagination way to get a UGC comments

user

Get user information in batch

Get user information

Obtain a user's friend list

Get the current logged-on user’s friend list in a does not installed application

Use pagination way to get a user and the user currently logged mutual friend

Get the current logged-on user’s friend list in a installed application

Get the current logged in user information

friend

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!

API2.0 Quota Description