返回更新记录
v0.7.3

API 合同变得可读、可试 (v0.7.3)

内置 OpenAPI 在线文档与 Scalar 浏览器,REST 管理能力可以直接探索和验证。

OpenAPIREST开发体验

新增的 OpenAPI 在线文档不需要额外的编译期工具,启动 Langhuan 后即可查看接口合同、认证方式和请求示例。开发者可以先在浏览器里理解资源边界,再把同一份合同带回自己的代码中。

从合同开始集成

Scalar 浏览器展示了真实运行时生成的 OpenAPI 文档,避免“文档写了一套、接口实现另一套”。文档里包含:

  • workspace、knowledge base、document、job 等资源的请求与响应结构。
  • Bearer 认证示例,以及与 API Key 页面对应的调用入口。
  • 文档导入、状态查询、检索和删除等核心流程的参数说明。
  • 错误响应和 workspace 隔离约束,减少把底层实现细节当成公共合同的风险。

管理能力开始成形

这一阶段也补齐了更多管理 API,收敛了对外暴露的接口范围,并把文档状态、删除行为和资源隔离统一到同一个 HTTP 边界里。API Key 页面现在可以直接跳转到在线文档,第一次接入不需要在仓库里来回寻找入口。

给自动化客户端的入口

REST API 适合脚本、后台服务和管理台;MCP over HTTP 继续提供面向工具调用的同一套知识库能力。两者共享 workspace 合同,方便把试验性的请求逐步升级成稳定的自动化流程。