查询知识详情

查询知识详情。

请求字段限制：

robotId：必填，机器人 ID
knowledgeId：必填，知识 ID

请求参数

名称	类型	必填	描述	示例值
appKey	string	是	应用 AppKey	1c088a89de51d0af457616605f28390f
time	int64	是	请求时间戳（秒）；与服务器时间误差超过 10 分钟会鉴权失败	1511832531
checksum	string	是	请求签名校验和	f570a5eb049eb803b086e45829b07e48
checksumAlgorithm	int32	否	签名算法：0-SHA-1，1-SHA-256；不传默认为 0（SHA-1）	0

请求体

名称	类型	必填	描述	示例值
robotId	int64	是	机器人 ID	123456
knowledgeId	int64	是	知识 ID	10000001

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示成功	200
message	string	响应消息	success
data	object
└id	int64	标准问题 ID
└name	string	标准问题名称
└similarityList	object[]	相似问列表
└id	int64	相似问题 ID
└name	string	相似问题名称
└answer	string	机器人答案
└categoryId	int64	分类 ID
└category	string	分类名称
└relatives	object[]	关联问题列表
└id	int64	关联问题 ID
└name	string	关联问题名称
└effectiveTime	int64	生效时间，毫秒时间戳
└failureTime	int64	失效时间，毫秒时间戳
└questionStatus	int32	问题状态：1-永久有效，2-有效期内有效，3-失效，4-未生效
└updateTime	int64	更新时间，毫秒时间戳
└validitySwitch	int32	是否开启有效期设置：0-未开启，1-开启
└channelAnswer	object
└type	int32	渠道答案类型：1-标签答案，2-渠道答案，3-时效答案
└data	object[]	渠道答案详情
└ids	int64[]	渠道答案值。标签答案为客户标签 ID，渠道答案为渠道来源 code
└ruleDesc	string	渠道来源值
└from	string	渠道来源
└effectiveTime	int64	生效时间，毫秒时间戳
└failureTime	int64	失效时间，毫秒时间戳
└answer	string	渠道答案
└userTags	string	客户标签
└userTagMatchType	int32	客户标签匹配类型：0-任一，1-全部
└multipleConsult	string	多次咨询规则
└keywords	string	精准关键词
└place	string	IP 地域
└goodsTitles	string	规则详情-商品订单信息-商品标题
└goodsIds	string	规则详情-商品订单信息-商品 ID
└goodsCNames	string	规则详情-商品订单信息-商品类目名称
└goodsCIds	string	规则详情-商品订单信息-商品类目 ID
└orderStageTypes	string	规则详情-商品订单信息-订单阶段类型
└gmcGoods	string	规则详情-商品订单信息-商品实体
└gmcCategory	string	规则详情-商品订单信息-商品类目
total	int32	分页总数，分页接口返回	100
requestId	string	链路请求 ID	0a1b2c3d4e5f
result	object	部分历史接口使用 result 字段承载业务数据

错误码

状态码	描述
14001	AppKey 缺失或不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON 对象，或参数缺失、格式非法
14009	频控限制：接口调用超过限流阈值
14500	服务内部错误
14501	数据查询范围超出限制
14515	当前 AppKey 无接口或资源访问权限

postEndpoint

/openapi/ai/knowledge/getDetail

curl -X POST "https://qiyukf.com/openapi/ai/knowledge/getDetail?appKey=1c088a89de51d0af457616605f28390f&time=1511832531&checksum=f570a5eb049eb803b086e45829b07e48" \  -H "Content-Type: application/json" \  -d '{    "knowledgeId": 10000001,    "robotId": 123456  }'

{
  "code": 200,
  "data": {},
  "message": "success"
}

{
  "code": 14001,
  "message": "AppKey not exists"
}

{
  "code": 14002,
  "message": "Bad checksum"
}

{
  "code": 14003,
  "message": "Bad time"
}

{
  "code": 14004,
  "message": "body内容json解析错误"
}

{
  "code": 14009,
  "message": "单位时间内请求过于频繁"
}

{
  "code": 14500,
  "message": "Internal error"
}

{
  "code": 14501,
  "message": "Data limit exceeded"
}

{
  "code": 14515,
  "message": "未开通机器人服务"
}