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 | Yes |
https://xxxxxx/v4/group_open_http_svc/set_group_attr?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/set_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, which should always be json . |
{"GroupId": "@TGS#aC5SZEAEF","GroupAttr":[{"key":"attr_key", //Attribute key"value":"attr_val" //Attribute value},{"key":"attr_key1","value":"attr_val1"}]}
Field | Type | Required | Description |
GroupId | String | Yes | The ID of the group for which you want to reset custom attributes |
GroupAttr | Array | Yes | List of custom attributes. key : Key of the custom attribute, which can be up to 32 bytes in length. Up to 16 keys are supported. value : Value of the custom attribute, which can be up to 4,000 bytes in length. |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode":0}
Field | Type | Description |
ActionStatus | String | Request result. OK : successful; FAIL : failed |
ErrorCode | Integer | Error code. 0 : Successful; other values: Failed |
ErrorInfo | String | Error information |
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 | No operation permissions. This error occurs when, for example, a group of this type does not support custom attribute operations. |
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. |
10045 | The size of the custom attribute key exceeds the limit of 32 bytes. |
10046 | The size of the custom attribute value exceeds the limit of 4000 bytes. |
10047 | The number of custom attribute keys exceeds the limit of 16. |
10048 | The total size of custom attribute values exceeds the limit of 16000 bytes. |
10049 | The frequency of writing custom attributes to a group exceeds the limit. You can add, delete, or modify them for up to 5 times per second. |
Was this page helpful?