# 知识库API使用须知

为了方便各业务线更便捷的管理薪火知识库,与自身业务系统结合。薪火知识库支持通过开放API实现对知识库中的文档/节点的自动化管理。

具体操作步骤如下:

第一步、创建一个数字伙伴并完成发布动作。 robot_create.png

第二步、在开发者选项页面打开文档api权限开关,并获取该数字伙伴的appkey、appsecret。 open_permission.png

第三步、将数字伙伴添加到需要管理的知识库成员列表中,获取相关的权限(管理、编辑、查看等)。 add_permission.png

第四步、通过第2步获取的appkey、appsecret,以数字伙伴的身份,调用不同的薪火知识库开放接口,管理维护知识库中的文档/节点信息。对节点的访问和管理管理权限以数字伙伴在知识库中的权限设置为准。

调用流程图 request_step.png

腾讯COS文件上传调用流程及参数介绍:

  1. 调用开放平台「上传秘钥获取」接口(/open/api/sts/get)获取临时秘钥key和secret(tmpSecretId, tmpSecretKey)以及bucket、region、key等参数
  2. 调用腾讯COS接口,具体调用方式可参考腾讯COS接口(也可使用腾讯COS SDK进行调用),详情地址:https://console.cloud.tencent.com/api/explorer?Product=cos&Version=2018-11-26&Action=PutObject
  3. 文件上传成功后会返回COS服务存储后的URL,将URL作为参数调用导入知识库节点接口的file_url字段即可
foo