# Octri 将 OpenAPI 定义转换为托管文档、SDK、MCP 工具和基于 SDK 的监控。 - Findings24: - 网站: - 价格: Freemium - 分类: AI开发者工具, AI 技术文档生成器, AI 软件开发工具包 ## 什么是 Octri？ Octri 是一个开发者平台，用于将 API 定义从规范转换为面向生产环境的工具。通过一个 OpenAPI、Swagger、Postman 或 AsyncAPI 源文件，它可以生成托管文档站点、客户端 SDK、供代理访问的 MCP 服务器，以及针对生成的 SDK 客户端的监控。该平台面向希望在规范发生变化时，让这些产物保持同步的 API 团队。 其文档产品将生成的参考资料与在线调试工具、搜索、AI 辅助文档和聊天功能，以及可供代理读取的索引相结合。其 SDK 产品最多可用十种语言生成客户端，并提供分页、流式传输、重试、超时、输出格式和请求钩子等选项。监控功能可跟踪问题，并针对生产客户端中观察到的问题配置提醒。 ## Octri 能做什么？ ### 生成 API 文档 API Studio 根据 API 定义创建托管参考页面，涵盖端点、字段、嵌套字段、响应错误、弃用信息，以及可运行的 cURL、JavaScript 和 Python 示例。 ### 可编辑的文档工作流 查看一次生成将修改的内容，在发布前编辑参考内容，并在后续重新生成时保留这些编辑，除非你明确将其移除。 ### 支持十种语言的 SDK 生成 SDK Studio 根据同一份规范生成客户端库；其主页说明支持十种语言，并提供分页、流式传输、重试、超时、输出格式和请求钩子等控制选项。 ### 可供代理读取的 API 访问 已发布的文档包含 Markdown 内容、llms.txt 索引，以及作为可调用工具公开的端点。Octri 的产品方案还包括 MCP 服务器，用于将 API 能力连接到代理。 ### 面向客户端的生产监控 监控功能跟踪 SDK 客户端产生的问题，并支持配置提醒条件，包括 5xx 激增、新问题、回归、身份验证失败、延迟、速率限制和 Webhook 投递失败。 ### 规范同步 每个方案均提供 GitHub 同步；合并后的规范变更会重新构建草稿，并在发布前提供差异供审批。 ## 使用场景 ### 从现有规范发布参考门户 API 团队可以将 OpenAPI、Swagger、Postman 或 AsyncAPI 文档导入 Octri，并发布带有可搜索参考页面、在线控制台、示例、架构和可供代理读取的索引。 ### 在 API 演进过程中维护文档 通过 GitHub 更新规范的团队可以查看生成的差异，有选择地重新生成发生变化的页面，并在后续运行中保留手动编辑的说明。 ### 向应用开发者分发类型化客户端 团队可以根据 API 合约生成 SDK，配置分页和重试等客户端行为，并提供遵循同一源定义的特定语言方法。 ### 将 API 操作连接到代理 开发者可以通过 MCP 工作流将已记录的端点公开为可调用工具，使代理能够搜索 API 文档并调用受支持的操作。 ### 调查生产环境中的 SDK 故障 工程或运维团队可以使用客户端监控查看错误和回归问题，然后针对 5xx 响应、401 失败、延迟或 429 速率限制激增等条件配置 Slack 或 Webhook 提醒。 ## 常见问题 ### Octri 接受哪些源格式？ API Studio 接受 JSON 或 YAML 格式的 OpenAPI 3.0 和 3.1、Swagger 2.0、Postman 以及 AsyncAPI 文件。 ### 我可以编辑生成的文档吗？ 可以。你可以在发布前编辑参考文档。Octri 会按页面存储编辑内容，后续重新生成时会保留这些编辑，除非你要求将其移除。 ### 支持多少种 SDK 语言？ Octri 宣传支持十种语言的 SDK 生成。不同方案包含的语言数量不同，符合条件的付费方案可以按固定月费增加语言；Business 方案包含全部十种语言。 ### 文档、SDK、监控和 MCP 需要分别购买吗？ 不需要。Octri 表示，一个方案涵盖全部四种产品。之后可以再启用它们，无需重新进行现有设置。 ### Octri 可以在我自己的基础设施中运行吗？ Enterprise 方案可以将生成器和文档渲染器运行在你自己的基础设施中。其他层级由 Octri 托管。 ## 快速信息 - **产品类别**: 用于 API 文档、SDK 生成、MCP 和监控的开发者工具 - **主要输入**: JSON 或 YAML 格式的 OpenAPI 3.0/3.1、Swagger 2.0、Postman 或 AsyncAPI - **SDK 覆盖范围**: 最多 10 种语言 - **文档输出**: 托管且可搜索的参考站点，包含在线控制台、示例、Markdown 和 llms.txt - **源同步**: GitHub 同步，支持草稿重建和差异审批 - **托管模式**: 标准层级由 Octri 托管；Enterprise 可在自己的基础设施中运行生成器和文档渲染器