产品简介

Theneo 是一款基于人工智能驱动的 API 文档平台，旨在帮助企业和开发者更轻松地创建、维护和发布高质量的 API 文档。它不仅仅是一个简单的文档生成工具，更是一个集成了多种功能的协作平台，能够无缝融入现有的开发工作流程，实现文档与代码的同步更新。Theneo 利用 AI 技术自动生成 API 参考文档、用户指南、发布说明和变更日志，极大地减少了手动编写文档所需的时间和精力。

该平台支持多种 API 规范格式，包括 Swagger、OpenAPI 和 GraphQL，用户可以轻松导入现有的 API 定义，或者使用平台内置的 Web 编辑器从头开始创建。Theneo 还提供了高度可定制的品牌外观，用户可以根据自己的品牌风格调整文档的布局、颜色、字体和 logo，确保 API 文档与企业品牌形象保持一致。通过提供公共和私有文档选项，Theneo 能够满足不同场景下的需求，无论是公开 API 以吸引开发者，还是保护内部 API 文档，都能轻松实现。Theneo 致力于简化 API 文档的创建和维护过程，从而提高 API 的易用性和采用率。

主要功能

• 即时文档生成： 通过拖拽上传 OpenAPI、Swagger 文件或 Postman 集合，或者直接链接代码仓库，Theneo 能够快速解析 API 模式、认证信息和示例，自动生成完整的 API 参考文档，省去了手动编写文档的繁琐步骤，极大地提高了文档生成效率。

• 集成持续部署： Theneo 与 GitHub、GitLab 和 Bitbucket 等代码托管平台实现原生集成，或者通过 CLI 工具，确保 API 文档与代码同步更新。每次代码提交时，Theneo 能够自动检测 API 规范和内容的变化，并实时更新文档，保证文档的准确性和时效性。

• 统一协作平台： Theneo 提供了一个集工程师、产品经理和技术文档编写人员于一体的协作环境，支持在线评论、修改建议和审批更新，实现团队成员之间的无缝协作，确保文档质量和一致性，并且支持通过 VS Code 等工具编辑文档。

• 公共和私有文档： 用户可以根据需要选择将 API 文档公开或私有化。公开文档有助于提升搜索引擎优化效果，吸引更多用户；私有文档则可以控制访问权限，邀请合作伙伴、访客和团队成员，并设置细粒度的端点级别权限，增强安全性。

• 自定义品牌外观： Theneo 允许用户自定义 API 文档的品牌外观，包括 logo、字体、主题和自定义 CSS，打造与自身品牌风格一致的专业 API 文档，无需重新构建网站，提升用户体验和品牌形象。

使用方法

1. 创建 Theneo 账号： 访问 Theneo 官网，注册并创建一个免费账号。
2. 创建新项目： 登录 Theneo 后，在主页添加一个新项目，选择 API 参考文档、开发者指南或其他文档类型。
3. 上传 API 规范： 上传已有的 Swagger、OpenAPI 或 GraphQL 格式的 API 规范文件，或者使用 Theneo 的 Web 编辑器从头开始创建 API 定义。
4. 选择 AI 助手： 根据需要选择是否使用 Theneo 的 AI 助手来丰富文档内容，可以选择自动生成内容、增强现有内容或不使用 AI 助手。
5. 设置权限和微调项目： 设置项目的可见性，邀请协作者，并根据工作流程需求进行精细调整。
6. 发布文档： 使用 Theneo 的编辑套件进行最后的调整，预览文档效果，然后发布文档，使其对用户可用。

应用场景

• 企业 API 文档管理： 大型企业可以使用 Theneo Enterprise 解决方案，实现 API 文档的集中化管理，支持自定义部署、高级安全性和可扩展工具，确保 API 文档的安全性和可靠性，并提升团队协作效率。

• 构建开发者门户： 通过 Theneo，企业可以构建功能丰富的开发者门户，包括授权平台、用户指南、社区论坛和个性化 API 访问等功能，提升开发者参与度和 API 的易用性，从而促进 API 的采用。

• API 版本控制和变更管理： Theneo 能够帮助企业维护多个 API 版本，标记弃用时间线，并自动从规范差异中生成变更日志，确保开发者及时了解 API 的更新和变化，减少集成问题。

• AI 驱动的 API 文档生成和维护： 借助 Theneo 的 AI 功能，企业可以自动生成 API 端点和参数描述，修复请求/响应示例，标记缺失或不一致的字段，总结复杂的模式，从而节省大量时间和人力成本，并确保文档的准确性和完整性。

• 创建交互式 API 参考文档： Theneo 能够生成交互式 API 参考文档，用户可以直接在文档中运行真实的 API 请求，并配置 API 密钥或 OAuth 2.0/OIDC 认证，从而提升开发者的使用体验和 API 的采用率。