Group Type ID | RESTful API Support |
Private | No. Same as work groups (Work) in the new version. |
Public | No |
ChatRoom | No. Same as meeting groups (Meeting) in the new version. |
AVChatRoom | Yes |
Community | No |
https://xxxxxx/v4/group_open_avchatroom_http_svc/modify_user_info?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_member_info | 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#a6I4ZUUGO","CommandType": 1,"MemberList": [{"Member_Account": "teacher10","Marks": [1000]},{"Member_Account": "student9","Marks": [1001]},]}
{"GroupId": "@TGS#a6I4ZUUGO","CommandType": 2,"MemberList": [{"Member_Account": "teacher10","Marks": [1000]},{"Member_Account": "student9","Marks": [1001]},]}
Field | Type | Required | Description |
GroupId | String | Yes | The ID of the Group whose historical messages will be modified |
CommandType | Integer | Yes | 1 : Mark setting; 2 : Mark deletion |
MemberList | Array | Yes | List of accounts for which marks are to be set. Up to 500 accounts are supported each time, and up to 10 different marks can be set for each group. A mark is a number greater than or equal to 1,000. |
{"ActionStatus": "OK","ErrorCode": 0,"ErrorInfo": "","CommandType": 1,"MemberList": [{"Member_Account": "teacher10","Marks": [1000]},{"Member_Account": "student9","Marks": [1001]}]}
Field | Type | Description |
ActionStatus | String | Request result. OK : successful; FAIL : failed |
ErrorCode | Integer | Error code. 0 : Successful; other values: Failed |
ErrorInfo | String | Error information |
MemberList | Object | List of members whose marks are successfully set. In the case of mark setting for a batch of accounts, if certain accounts are offline, the backend does not return the offline accounts; if all accounts are offline or do not exist, the backend returns a failure result. |
Mark | Description |
500 | When mark 500 is set for a member, the member is considered to be always online (disconnection events ignored) for a maximum of three days. |
600 | When a member is set with mark 600, the member is hidden when the list of online members is pulled, unless the list is explicitly specified to be pulled by the member's mark. |
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 |
10001 | The user is not logged in. Check whether the admin account and usersig are correct. |
10002 | A system error occurred. Try again or contact technical support. |
10003 | The request command is invalid. Try again or contact technical support. |
10004 | A parameter is invalid. Check the ErrorInfo field in the response packet to see whether the required fields have been specified or whether the fields are set according to protocol requirements. |
10007 | Insufficient permission. Only the app admin or group owner can call this API. |
10010 | The group does not exist or has been deleted. |
10015 | The group ID is invalid. Please check the group ID. |
Was this page helpful?