Skip to main content

Set friend request verification level

Set the friend request verification level for one or more users.

Request method

POST: https://Base URL/v4/friend/permission/set

Rate limit: 100 requests per second (rate limit counts each user in the batch individually; setting 10 users counts as 10 requests)

Signature required: All server API requests require signature verification. See API request signature.

Request body

The request body is in application/json format and supports the following parameters:

ParameterTypeRequiredDescription
userIdsString[]YesUser IDs. Maximum 100 per request.
permissionTypeStringYesVerification level: 1 = anyone can add as a friend directly. 2 = requires approval to add as a friend. 3 = no one can send friend requests.

Request example

HTTP
POST /v4/friend/permission/set HTTP/1.1
Host: api.sg-light-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json

{
"userIds": ["id1", "id2", "id3", "id4"],
"permissionType": 1
}

Response

FieldTypeDescription
codeNumberStatus code. 0 indicates success.

Response example

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

{
"code": 0
}