在线系统服务时间
查询服务时间配置
按配置类型查询企业服务时间配置。接口使用七鱼开放接口签名鉴权,并受开放接口频控限制。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 企业 AppKey。 | |
| time | int64 | 是 | 当前 UTC 时间戳,从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。 | |
| checksum | string | 是 | 请求签名,签名规则参考通用说明的数据校验。 | |
| checksumAlgorithm | integer | 否 | 签名算法版本,默认 0。 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| type | int32 | 是 | 服务时间配置类型,具体枚举以在线系统服务时间配置为准 | 1 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务状态码,200 表示成功。 | 200 |
| message | string | 响应信息。成功时该字段通常为空或不返回。 | success |
| data | object | 服务时间配置。 | |
| └enable | int32 | 是否开启服务时间配置,1 表示开启,0 表示关闭。 | 1 |
| └serviceTimeInfoList | object[] | 服务时间配置列表。 | |
| └id | int64 | 服务时间配置 ID。 | 10001 |
| └type | int32 | 配置类型,具体枚举以在线系统服务时间配置为准。 | 1 |
| └serviceTimeTemplateId | int64 | 服务时间模板 ID。 | 20001 |
| └isDefault | boolean | 是否默认配置。 | true |
| └showName | string | 客服组或渠道展示名称。 | 售前客服组 |
| └operator | string | 更新人。 | admin |
| └updateTime | int64 | 更新时间,毫秒时间戳。 | 1716446400000 |
错误码
| 状态码 | 描述 |
|---|---|
| 400 | 请求参数格式错误、缺少必要字段或请求体不是合法 JSON。 |
| 401 | 鉴权失败、签名错误、AppKey 不存在或 time 超出允许范围。 |
| 500 | 服务端处理异常。 |
| 8002 | 业务错误码,HTTP 状态码仍为 200:参数错误,常见于请求体 JSON 不合法、缺少必填字段或字段格式不合法。 |
| 8003 | 业务错误码,HTTP 状态码仍为 200:业务状态错误,例如质检任务状态错误或任务类型不匹配。 |
| 8501 | 业务错误码,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/chat/service/time/configcurl -X POST "https://qiyukf.com/openapi/chat/service/time/config?appKey=1c088a89de51d0af457616605f28390f&time=1716446400&checksum=e72be4487b6fc03e0f914fc11e4053d771598d93&checksumAlgorithm=0" \ -H "Content-Type: application/json" \ -d '{ "type": 1 }'{
"code": 200,
"message": "success",
"data": {
"enable": 1,
"serviceTimeInfoList": [
{
"id": 10001,
"type": 1,
"serviceTimeTemplateId": 20001,
"isDefault": true,
"showName": "售前客服组",
"operator": "admin",
"updateTime": 1716446400000
}
]
}
}空
空
空
{
"code": 8002,
"message": "参数错误,常见于请求体 JSON 不合法、缺少必填字段或字段格式不合法。"
}{
"code": 8003,
"message": "业务状态错误,例如质检任务状态错误或任务类型不匹配。"
}{
"code": 8501,
"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": "系统内部错误。"
}这篇文档有帮助吗?