Add Friend

Send a friend request.

Enable the Service

Before calling this API, enable the profile hosting service by submitting a ticket.

Request Method

POST: https://data center domain/friend/add.json

Rate Limit: 100 requests per second

Signature Rule: All server API requests require signature verification. See API Request Signature.

Request Parameters

The HTTP request body uses application/x-www-form-urlencoded format and supports the following form parameters:

Parameter	Type	Required	Description
userId	String	Yes	The user ID initiating the request.
targetId	String	Yes	The user ID to be added as a friend.
optType	Number	No	Request type: 1: Add friend based on target user's verification level (default); 2: Add directly without target user's approval
extra	String	No	Additional information for the friend request (max 128 characters).

Request Example

POST /friend/add.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

userId=id1&targetId=id2&optType=2&extra=something

Response

The HTTP response body contains a JSON object with the following structure:

Field	Type	Description
code	Number	Status code (200 indicates success).

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "code": 200,
}