七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
客户管理

查询用户服务记录

根据用户 uid 查询该用户的服务记录。uid 为必填字段,不能为空。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳(秒)
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0 - 默认(SHA1),1 - SHA256

请求体

名称类型必填描述示例值
uidstring是用户唯一标识user_12345

返回参数

名称类型描述示例值
resultobject[]服务记录列表
└sessionTypeint32会话类型:0-在线,1-呼叫,6-工单0
└idint64记录 ID10001
└statusint32会话状态2
└startTimeint64开始时间(毫秒时间戳)1700000000000
└closeTimeint64结束时间(毫秒时间戳)1700003600000
└categoryPathstring分类路径售前咨询/产品问题
└mobilestring用户手机号13800138000
└userNamestring用户姓名张三
└uidstring用户唯一标识(foreignId)user_12345
└staffNamestring坐席姓名李四
└satisfactionNamestring满意度名称满意
└platformstring会话平台(在线会话)web
└callNumstring呼叫号码(呼叫中心)0571-88888888
└recordSrcstring录音地址(呼叫中心)https://record.example.com/123.wav
└worksheetCreateTimeint64工单创建时间(毫秒时间戳)1700000100000
└workSheetTitlestring工单标题售后咨询
└workSheetDealerstring工单处理人王五
└workSheetDealGroupstring工单处理组售后组
totalint32总记录数10

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求体 JSON 格式错误或 uid 缺失
14500服务内部异常
postEndpoint
/openapi/user/service/record
POST
/openapi/user/service/record
curl -X POST "https://qiyukf.com/openapi/user/service/record?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "uid": "user_12345"  }'
{
  "result": [
    {
      "sessionType": 0,
      "id": 10001,
      "status": 2,
      "startTime": 1700000000000,
      "closeTime": 1700003600000,
      "categoryPath": "售前咨询/产品问题",
      "mobile": "13800138000",
      "userName": "张三",
      "uid": "user_12345",
      "staffName": "李四",
      "satisfactionName": "满意",
      "platform": "web",
      "callNum": "0571-88888888",
      "recordSrc": "https://record.example.com/123.wav",
      "worksheetCreateTime": 1700000100000,
      "workSheetTitle": "售后咨询",
      "workSheetDealer": "王五",
      "workSheetDealGroup": "售后组"
    }
  ],
  "total": 10
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求体 JSON 格式错误或 uid 缺失"
}
{
  "code": 14500,
  "message": "服务内部异常"
}

这篇文档有帮助吗?