https://xxxxxx/v4/sns/group_get?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Parameter | Description |
https | The request protocol is HTTPS, and the request method is POST. |
xxxxxx | 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 India: adminapiind.im.qcloud.com Silicon Valley: adminapiusa.im.qcloud.com Jakarta: adminapiidn.im.qcloud.com |
v4/sns/group_get | Request API |
sdkappid | SDKAppID assigned by the IM console when an app is created |
identifier | |
usersig | Signature generated in the app admin account. For details on how to generate the signature, please see Generating UserSig. |
random | A random 32-bit unsigned integer ranging from 0 to 4294967295 |
contenttype | Request format. The value is always json . |
{"From_Account":"id"}
{"From_Account":"id","NeedFriend":"Need_Friend_Type_Yes","GroupName": ["group1"]}
Field | Type | Required | Description |
From_Account | String | Yes | UserID of the account for which to pull friend lists |
NeedFriend | String | No | Whether to pull the users in the list. Need_Friend_Type_Yes : pulls users. If this field is left empty, users will not be pulled. It is valid only when GroupName is left empty. |
GroupName | Array | No | Name of the list to pull |
{"ResultItem": [{"GroupName": "group1","FriendNumber": 1},{"GroupName": "group2","FriendNumber": 2},{"GroupName": "group3","FriendNumber": 3}],"CurrentSequence": 2,"ActionStatus": "OK","ErrorCode": 0,"ErrorInfo": "","ErrorDisplay": ""}
{"ResultItem": [{"GroupName": "group1","FriendNumber": 1,"To_Account": ["friend1"]}],"CurrentSequence": 2,"ActionStatus": "OK","ErrorCode": 0,"ErrorInfo": "","ErrorDisplay": ""}
Field | Type | Description |
ResultItem | Array | Result object array of pulling lists |
GroupName | String | List name |
FriendNumber | Integer | Number of friends in the list |
To_Account | Array | UserID of friends in the list |
CurrentSequence | Integer | Current sequence of the lists |
ActionStatus | String | Request result. OK : successful; FAIL : failed |
ErrorCode | Integer | |
ErrorInfo | String | Detailed error information |
ErrorDisplay | String | Detailed information displayed on the client |
ResultCode
, ResultInfo
, ErrorCode
, and ErrorInfo
.
For public error codes (60000 to 79999), please see Error Codes.
The following table describes the error codes specific to this API:Error Code | Description |
30001 | Incorrect request parameter. Check your request according to the error description. |
30003 | The requested account does not exist. |
30004 | The request requires app admin permissions. |
30006 | Internal server error. Try again. |
30007 | Network timeout. Try again later. |
Was this page helpful?