七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
在线系统消息管理

消息回调连通性测试

用于开放接口消息回调调试,接收回调请求并按测试内容返回结果。

请求参数

名称类型必填描述示例值
timeint64是当前 UTC 时间戳,从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。
checksumstring是请求签名,签名规则参考通用说明的数据校验。
eventTypestring是

请求体

名称类型必填描述示例值
msgTypestring是消息类型,详见 消息类型说明text
contentstring是测试消息内容。文本消息传 NotEmpty 时接口会返回 NotEmptyhello

返回参数

连通性测试响应,实际响应体为字符串。

错误码

状态码描述
400请求参数格式错误、缺少必要字段或请求体不是合法 JSON。
401鉴权失败、签名错误、AppKey 不存在或 time 超出允许范围。
500服务端处理异常。
8002业务错误码,HTTP 状态码仍为 200:参数错误,常见于请求体 JSON 不合法、缺少必填字段或字段格式不合法。
8003业务错误码,HTTP 状态码仍为 200:业务状态错误,例如质检任务状态错误或任务类型不匹配。
14001业务错误码,HTTP 状态码仍为 200:AppKey 不存在或无效。
14002业务错误码,HTTP 状态码仍为 200:checksum 签名校验失败。
14003业务错误码,HTTP 状态码仍为 200:time 与服务器时间相差超过允许范围,或时间参数为空。
14004业务错误码,HTTP 状态码仍为 200:请求内容错误,例如请求体格式错误、缺少必填字段或字段值不合法。
14005业务错误码,HTTP 状态码仍为 200:无客服在线。
14006业务错误码,HTTP 状态码仍为 200:访客正在排队。
14008业务错误码,HTTP 状态码仍为 200:IP 白名单限制或 IP 被拦截。
14009业务错误码,HTTP 状态码仍为 200:请求过于频繁。
14010业务错误码,HTTP 状态码仍为 200:留言功能关闭。
14011业务错误码,HTTP 状态码仍为 200:接口未开放或被停用。
14014业务错误码,HTTP 状态码仍为 200:访客处于挂起状态。
14015业务错误码,HTTP 状态码仍为 200:访客正在分流中。
14500业务错误码,HTTP 状态码仍为 200:系统内部错误。
postEndpoint
/openapi/message/recv
POST
/openapi/message/recv
curl -X POST "https://qiyukf.com/openapi/message/recv?time=0&checksum=string&eventType=string" \  -H "Content-Type: application/json" \  -d '{    "msgType": "text",    "content": "hello"  }'
""
空
空
空
{
  "code": 8002,
  "message": "参数错误,常见于请求体 JSON 不合法、缺少必填字段或字段格式不合法。"
}
{
  "code": 8003,
  "message": "业务状态错误,例如质检任务状态错误或任务类型不匹配。"
}
{
  "code": 14001,
  "message": "AppKey 不存在或无效。"
}
{
  "code": 14002,
  "message": "checksum 签名校验失败。"
}
{
  "code": 14003,
  "message": "time 与服务器时间相差超过允许范围,或时间参数为空。"
}
{
  "code": 14004,
  "message": "请求内容错误,例如请求体格式错误、缺少必填字段或字段值不合法。"
}
{
  "code": 14005,
  "message": "无客服在线。"
}
{
  "code": 14006,
  "message": "访客正在排队。"
}
{
  "code": 14008,
  "message": "IP 白名单限制或 IP 被拦截。"
}
{
  "code": 14009,
  "message": "请求过于频繁。"
}
{
  "code": 14010,
  "message": "留言功能关闭。"
}
{
  "code": 14011,
  "message": "接口未开放或被停用。"
}
{
  "code": 14014,
  "message": "访客处于挂起状态。"
}
{
  "code": 14015,
  "message": "访客正在分流中。"
}
{
  "code": 14500,
  "message": "系统内部错误。"
}

这篇文档有帮助吗?