Skip to main content

Overview

Updates user settings.

Request

Authentication: Add authentication headers to the request. See Authentication

Method: POST

Rate limit: 100 requests/second

Endpoint: https://API domain/jim/users/updsettings

Content-Type: application/json

Request parameters

ParameterData typeRequiredDescription
languagestringYesPush notification language.
friend_verify_typeintYesFriend verification: 0 no verification required; 1 approval required; 2 reject all friend requests.
grp_verify_typeintYesGroup join verification: 0 no verification required; 1 my approval required; 2 reject all group invitations.
undisturb.switchboolNoWhether to enable global Mute Notifications. When enabled, messages are muted during the time period specified in rules; if no period is specified, notifications are muted all day.
undisturb.timezonestringNoTime zone for the period. If empty, the default time zone where the server is deployed is used.
undisturb.rules.startstringNoStart time for Mute Notifications, in HHmm 24-hour format.
undisturb.rules.endstringNoEnd time for Mute Notifications, in HHmm 24-hour format.

Request example

POST /jim/users/updsettings HTTP/1.1
appkey: appkey
Authorization: xxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
"language":"zh_CN",
"friend_verify_type":1,
"grp_verify_type":1,
"undisturb":{
"switch":true,
"timezone":"",
"rules":[
{
"start":"1100",
"end":"1500"
}
]
}
}

Response example

{
"code":0,
"msg":"sucess"
}

Response codes

Response codesDescription