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 | Yes |
https://xxxxxx/v4/group_open_avchatroom_http_svc/get_members?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_avchatroom_http_svc/get_members | 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","Timestamp": 0}
1000
will be obtained.{"GroupId":"@TGS#a6I4ZUUGO","Mark": 1000,"Timestamp": 0}
Field | Type | Required | Description |
GroupId | String | Yes | ID of the target group |
Timestamp | Integer | Yes | For the first request, the value is 0 . If the audio-video group has 500 or less members, the backend returns all members and NextTimestamp with the value 0 . If the audio-video group has more than 500 members, the backend returns NextTimestamp with a non-zero value, which is used as the value of Timestamp for the next request for pulling the remaining members. |
{"ActionStatus": "OK","ErrorCode": 0,"ErrorInfo": "","MemberList": [{"JoinTime": 1657773110,"Member_Account": "teacher2","NickName": "Teacher t02","Avatar": "http://www.example.com/teacher2.jpg"}],"NextTimestamp": 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 |
MemberList | Object | Online accounts of the group. Member_Account is the UserID of a user, and JoinTime is the time when the user joined the group. |
NextTimestamp | Integer | Pulling-by-page flag. If the value is not 0 , more members can be returned. You need to set the value in the Timestamp request parameter to pull more members. If it is 0 , all the members have been returned. |
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 | You do not have required permissions. You can only obtain the number of online users for audio-video groups. |
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?