句子秒懂 API
  1. Insight Open API
句子秒懂 API
  • 🍊 句子专属知识库
  • Insight Open API
    • 接口鉴权指南
    • 对话
      • 对话接口
      • 开始语音通话
      • 结束语音通话
    • 流程引擎
      • 获取流程引擎事件列表
      • 获取流程引擎执行历史
      • 添加历史消息到流程引擎
      • 触发流程引擎事件
      • 创建批量执行任务
      • 追加子任务
      • 提交批量任务
    • 知识库
      • 文档
        • 段落
          • 获取段落列表
          • 创建段落
          • 更新段落
          • 删除段落
        • 获取文档列表
        • 获取文档详情
        • 创建文档
        • 更新文档信息
        • 删除文档
        • 创建文档-自动分段
      • 网页
        • 创建网页-自动分段
      • FAQ
        • 创建 FAQ
      • 获取知识库列表
      • 获取知识库信息
      • 创建知识库
      • 更新知识库信息
      • 删除知识库
    • 回调接口
      • 点赞踩回调
      • 批量任务子任务执行结果回调
    • 资料库
      • 资料库开发
    • 获取 access token
      POST
  1. Insight Open API

接口鉴权指南

Insight Open API 可以提供完整的接口来进行二次开发,对接例如微信公众号,微信小程序,内部系统等对话渠道,使得在句子专属知识库搭建好的机器人可以在各个地方为客户提供服务。
所有的接口都在/openapi路径下

鉴权#

获取密钥参数#

你需要从秒懂后台获取以下凭据
accessKeyId: 访问密钥ID
accessKeySecret: 访问密钥密码
具体位置如下图
image.png

获取 accessToken#

通过接口获取 access token,具体参考接口文档内的调用方式
获取到的accessToken接口返回值里,会有expiresIn参数,所有的accessToken会有2小时的有效期,到期之后就无法继续使用,需要重新调用获取 access token接口来获取新的accessToken

获取accessToken接口特性说明#

新创建的accessToken有效期是2小时
在当前存在有效期超过半小时的accessToken时重复调用当前接口,会返回已存在的accessToken,而非生成新的accessToken
当不存在有效的accessToken或当前有效的accessToken的有效期不足半小时的时候,调用此接口之后系统会创建新的accessToken,创建完成之后,新的accessToken和旧的accessToken同时生效,此时用旧的或新的accessToken调用接口均不会出现鉴权失败的情况
有效期的示意图如下
image.png
修改于 2025-10-16 13:35:47
上一页
🍊 句子专属知识库
下一页
对话接口
Built with