This API is used to delete specified friend lists.
https://xxxxxx/v4/sns/group_delete?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
The following table only describes the modified parameters when this API is called. For more information on other parameters, please see RESTful API Overview.
Parameter | Description |
---|---|
https | The request protocol is HTTPS, and the request method is POST. |
xxxxxx | The country/region where your SDKAppID is located.console.tim.qq.com adminapisgp.im.qcloud.com adminapikr.im.qcloud.com adminapiger.im.qcloud.com adminapiind.im.qcloud.com |
v4/sns/group_delete | Request API. |
sdkappid | The SDKAppID assigned by the IM console when an application is created. |
identifier | The app administrator account. For more information, please see the App Admin section in Login Authentication. |
usersig | The signature generated by the app administrator account. For more information 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 . |
200 calls per second
{
"From_Account":"id",
"GroupName":["group1","group2","group3"]
}
Field | Type | Required | Description |
---|---|---|---|
From_Account | String | Yes | UserID of the account for which to delete lists. |
GroupName | Array | Yes | The friend lists to be deleted. |
{
"CurrentSequence": 4,
"ActionStatus":"OK",
"ErrorCode":0,
"ErrorInfo":"0",
"ErrorDisplay":""
}
Field | Type | Description |
---|---|---|
CurrentSequence | Integer | The current sequence of the lists. |
ActionStatus | String | Request result. OK : successful. FAIL : failed. |
ErrorCode | Integer | Error code. 0 : successful. Other values: failed. For details on non-zero results, please see Error Codes. |
ErrorInfo | String | Detailed error information. |
ErrorDisplay | String | Detailed information displayed on the client. |
Error Code | Description |
---|---|
30001 | Incorrect request parameter. Check your request according to the error description. |
30003 | The requested user account does not exist. |
30004 | The request requires app administrator permissions. |
30006 | Internal server error. Please try again. |
30007 | Network timeout. Please try again later. |
30008 | A write conflict has occurred due to concurrent writes. You are advised to use batch processing. |
Use the RESTful API online debugging tool to debug this API.
Adding Lists (v4/sns/group_add)
</span id="errorcode">
Was this page helpful?