# 接口说明

对DUIX创建的应用进行管理,包括并发管理,会话查询,会话关闭,三方话术对接等。

# 使用须知

  1. 客户通过appId和appSecret获取token,所有管理接口的HTTP Header中需要放入token才可以请求对应的接口。
  2. 为了保证对话效果,提供给duix访问的三方话术接口需要达到20s以内的响应速度。

# 交互流程

image.png

# 公共请求头

字段 类型 是否必须 备注
token String Y 通过appId和appSecret获取token

# 公共返回参数

duix得到token和其他请求数据集合后,会先进行安全校验等验证,一系列验证通过后便会处理完成这次发送过来的数据请求,平台返回的参数格式如下:

字段 类型 是否必须 备注
code String Y 返回的状态码,为0表示成功
message String N 成功/错误的描述信息
data object N 返回的具体内容
success Boolean Y 是否成功

下文中如没有特殊说明,对返回值的解释都是指data内部的结构。

# 公共错误码

错误码 描述
0 正常
-1 系统异常
1005 token不能为空
1006 toke失效
1007 话术信息不存在
1009 用户可用次数不足
2002 会话信息不存在
40001 appid或者appscrect无效
40002 内部错误