Group Type ID | RESTful API Support |
Private | Yes. Same as work groups (Work) in the new version. |
Public | Yes |
ChatRoom | Yes. Same as the meeting group (Meeting) in the new version. |
AVChatRoom | Yes |
Community | No |
https://xxxxxx/v4/group_open_http_svc/update_group_counter?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Parameter | Description |
xxxxxx | Domain name corresponding to the country/region where your SDKAppID is located. China: console.tim.qq.com Singapore: adminapisgp.im.qcloud.com Seoul: adminapikr.im.qcloud.com Frankfurt: adminapiger.im.qcloud.com Silicon Valley: adminapiusa.im.qcloud.com Jakarta: adminapiidn.im.qcloud.com |
v4/group_open_http_svc/modify_group_attr | Request API |
sdkappid | SDKAppID assigned by the Chat console when an app is created |
identifier | |
usersig | |
random | A random 32-bit unsigned integer ranging from 0 to 4294967295. |
contenttype | Request format. The value is fixed to json . |
{"GroupId": "@TGS#aC5SZEAEF","GroupCounter":[{"Key":"like", // Group counter key"Value":5 // Group counter value},{"Key":"unlike","Value":1}],"Mode": "Set" // `Set`, `Increase`, `Decrease`}
Field | Type | Required | Description |
GroupId | String | Yes | Group ID |
GroupCounter | Array | Yes | List of group counters. Key indicates the key of the group counter. The list can contain up to 20 keys, with each key containing no more than 128 bytes. Value indicates the value of the group counter, which is a 64-bit signed integer. |
Mode | String | No | Increase and Decrease indicate increasing or decreasing the original value respectively. If the Key does not exist, create one with Value being 0 and then increase or decrease the value. Set indicates setting Value corresponding to the Key . |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0,"GroupCounter":[ // List of the latest group counter key-value pairs updated{"Key":"like", // Group counter key"Value":5 // Latest group counter value},{"Key":"unlike","Value":1}]}
Field | Type | Description |
ActionStatus | String | Request result. OK : Successful; FAIL : Failed |
ErrorCode | Integer | Error code. 0 : Successful; other values: Failed |
ErrorInfo | String | Error information |
GroupCounter | Array | List of the latest group counter key-value pairs updated |
ErrorCode
and ErrorInfo
respectively.
For public error codes (60000 to 79999), see Error Codes.
The following table describes the error codes specific to this API:Error Code | Description |
10002 | Internal server error. Try again. |
10004 | Invalid parameter. Check the error description and troubleshoot the issue. |
10007 | Insufficient operation permission. For example, the current user is not a group member. |
10010 | The group does not exist or has been deleted. |
10015 | Invalid group ID. Check whether the group ID is entered correctly and whether the group exists. |
10059 | To use this feature, you need to purchase the Premium edition. |
10063 | The number of keys in the group counter exceeds the limit of 20. |
Was this page helpful?