https://xxxxxx/v4/recentcontact/get_contact_group?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/recentcontact/get_contact_group | 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 . |
{"From_Account":"user0","StartIndex":0}
Field | Type | Required | Description |
From_Account | String | Yes | UID of the requester |
StartIndex | Integer | Yes | Start index for the current page pulling. Enter 0 for the first pull and enter the value of NextStartIndex returned last time. |
{"ContactItem": [{"Type": 1,"To_Account": "teacher4","StandardMark": "111001","ContactGroupId": [1,2],"Timestamp": 1670843110},{"Type": 2,"ToGroupId": "@TGS#1N3RSUYG2","StandardMark": "111001","CustomMark": "abcd","Timestamp": 1672998266}],"GroupItem": [{"GroupName": "test1x","GroupId": 1},{"GroupName": "test10","GroupId": 2}],"CompleteFlag": 1,"NextStartIndex": 0,"ActionStatus": "OK","ErrorCode": 0,"ErrorInfo": ""}
Field | Type | Description |
ActionStatus | String | Request result. OK : Successful; FAIL : Failed |
ErrorCode | Integer | Error code. 0 : Successful; other values: Failed |
ErrorInfo | String | Error information |
ContactItem | Integer | Conversation object |
Type | String | Conversation type. 1 : One-to-one conversation; 2 : Group conversation |
ToGroupId | String | Group ID |
To_Account | String | User ID |
Timestamp | Integer | Last update timestamp of the conversation group |
StandardMark | String | Standard mark capability bit, for example, 011111110 |
CustomMark | String | Custom mark |
ContactGroupId | Array | Group to which the conversation belongs |
CompleteFlag | Integer | Required |
NextStartIndex | Integer | Required |
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 |
50001 | The requested UserID has not been imported into the Tencent Cloud Chat backend. Please import. |
50002 | Incorrect request parameter. Check your request according to the error description. |
50003 | The request requires app admin permissions. |
50004 | Internal server error. Please try again. |
50005 | Network timeout. Try again later. |
51006 | When you are modifying conversation mark, the number of conversations is empty or exceeds the upper limit of 100. |
51007 | Failed to replace GroupID with GroupCode because an internal error occurred or the group was disbanded. |
51008 | The total number of conversations in the conversation group exceeds 1,000. |
51009 | The conversation group does not exist when a deletion attempt is made. |
51010 | The number of conversation groups exceeds the upper limit of 20. |
51011 | The conversation group name contains more than 32 bytes. |
51012 | Exceeded the maximum number of conversations pinned to the top. |
51013 | If the requested app is not of the Premium edition, an error will be reported when a standard conversation mark or conversation group is modified. |
Was this page helpful?