Skip to main content

Get Current User's Paginated Conversation List

Brief Description

  • Get Current User's Paginated Conversation List

Request Method

  • post

Request URL

  • {API_ADDRESS}/conversation/get_owner_conversation
Header NameExample ValueOptionalTypeDescription
operationID1646445464564RequiredstringUsed for global trace tracking, recommended to use a timestamp, unique for each request
tokeneyJhbxxxx3XsRequiredstringAdmin token

Request Parameter Example

{
"userID": "1008432211",
"pagination": {
"pageNumber": 1,
"showNumber": 20
}
}
Field NameOptionalTypeDescription
userIDRequiredstringCurrent User ID
paginationRequiredobjectPagination parameter object
pagination.pageNumberRequiredstringCurrent page number, starting from 1
pagination.showNumberRequiredstringNumber of items per page

Successful Response Example

{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"total": 38,
"conversations": [
{
"ownerUserID": "1008432211",
"conversationID": "sg_1012900607",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "1012900607",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 0,
"minSeq": 0,
"maxSeq": 184,
"msgDestructTime": 0,
"latestMsgDestructTime": -62135596800000,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_1084800774",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "1084800774",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 30,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 604800,
"latestMsgDestructTime": 1695265099982,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_1300152726",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "1300152726",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 30,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 604800,
"latestMsgDestructTime": 1700464579733,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_1760150676",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "1760150676",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 30,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 604800,
"latestMsgDestructTime": 1694565537524,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_1959004809",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "1959004809",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 30,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 604800,
"latestMsgDestructTime": 1693526134219,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_198075251",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "198075251",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 0,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 0,
"latestMsgDestructTime": -62135596800000,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_198617661",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "198617661",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 0,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 0,
"latestMsgDestructTime": -62135596800000,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_2211210937",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "2211210937",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 30,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 604800,
"latestMsgDestructTime": 1698321453986,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_2338619613",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "2338619613",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 4,
"ex": "",
"burnDuration": 30,
"minSeq": 0,
"maxSeq": 268,
"msgDestructTime": 604800,
"latestMsgDestructTime": 1695175479581,
"isMsgDestruct": false
},
{
"ownerUserID": "1008432211",
"conversationID": "sg_2590740935",
"recvMsgOpt": 0,
"conversationType": 3,
"userID": "",
"groupID": "2590740935",
"isPinned": false,
"attachedInfo": "",
"isPrivateChat": false,
"groupAtType": 0,
"ex": "",
"burnDuration": 30,
"minSeq": 0,
"maxSeq": 0,
"msgDestructTime": 604800,
"latestMsgDestructTime": 1694565650924,
"isMsgDestruct": false
}
]
}
}

Explanation of Successful Response Parameters

Parameter NameTypeDescription
errCodeintError code, 0 indicates success
errMsgstringBrief error message, empty when successful
errDltstringDetailed error message, empty when successful
dataobjectGeneral data object, see structure below
totalstringTotal number of conversations
conversationsarrayList of Conversations

Failure Response Example

{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}

Explanation of Failure Response Parameters

Parameter NameTypeDescription
errCodeintError code, refer to the global error code documentation
errMsgstringBrief error message
errDltstringDetailed error message