跳到主要内容

获取当前用户的会话列表​

简要描述​

  • 获取当前用户的会话列表

请求方式​

  • post

请求URL​

  • {API_ADDRESS}/conversation/get_owner_conversation
header名示例值选填类型说明
operationID1646445464564必填string用于全局链路追踪，建议使用时间戳，在每个请求中独立
tokeneyJhbxxxx3Xs必填string管理员 token

请求参数示例​

{
  "userID": "1008432211",
  "pagination": {
    "pageNumber": 1,
    "showNumber": 20
  }
}
字段名选填类型说明
userID必填string当前用户ID
pagination必填object分页参数结构体
pagination.pageNumber必填string当前页码，从1开始
pagination.showNumber必填string当前页请求数量

成功返回示例​

{
  "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
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_2849984129",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "2849984129",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 0,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1695175496783,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_2978362440",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "2978362440",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 5,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1694569026129,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3140024257",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3140024257",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 0,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1695175468085,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3179761042",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3179761042",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 0,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1693525753518,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3187706596",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3187706596",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 4,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 0,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1693364218123,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3327367899",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3327367899",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 0,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1694375242097,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3419642055",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3419642055",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 0,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1700445790936,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3561750878",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3561750878",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 0,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1695175484281,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3710129094",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3710129094",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 3,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1697081735129,
        "isMsgDestruct": false
      },
      {
        "ownerUserID": "1008432211",
        "conversationID": "sg_3905809684",
        "recvMsgOpt": 0,
        "conversationType": 3,
        "userID": "",
        "groupID": "3905809684",
        "isPinned": false,
        "attachedInfo": "",
        "isPrivateChat": false,
        "groupAtType": 0,
        "ex": "",
        "burnDuration": 30,
        "minSeq": 0,
        "maxSeq": 2,
        "msgDestructTime": 604800,
        "latestMsgDestructTime": 1695622938140,
        "isMsgDestruct": false
      }
    ]
  }
}

成功返回示例的参数说明​

参数名类型说明
errCodeint错误码，0表示成功
errMsgstring错误简要信息，为空
errDlterrDlt错误详细信息，为空
dataobject通用数据对象，具体结构见下方
totalstring会话总数
conversationsarray会话列表

失败返回示例​

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

失败返回示例的参数说明​

参数名类型说明
errCodeint错误码，具体查看全局错误码文档
errMsgstring错误简要信息
errDlterrDlt错误详细信息