Theneo 想为所有开发者带来类似 Stripe 的 API 文档

Theneo 想为所有开发者带来类似 Stripe 的 API 文档

一家新公司正在从 Stripe 的 API 手册中汲取经验,其平台使任何公司都可以轻松创建清晰的 API 文档,同时还允许非技术团队成员为该流程做出贡献。

作为本周 TC Disrupt 的战地 200 队列的一部分,TechCrunch 与 Theeo 会面,了解他们计划如何在 45 亿美元的 API 管理市场中分得一杯羹——预计这一数字将在五年内上升到近 140 亿美元.

API 或“应用程序编程接口”是将大多数现代软件结合在一起的粘合剂。 它们使优步无需从头开始构建整个基础设施即可提供应用内消息传递,健身应用可通过地图和在线商家可视化您的跑步历史,以支持由 Stripe 提供支持的支付。 在内部,公司还创建自己的 API 来连接各种后端系统和数据存储。

简而言之,API 是现代技术时代隐藏的、常常是默默无闻的英雄。 但是,创建一个易于开发人员使用和采用的 API 带来了固有的挑战。 仅仅构建 API 是不够的——它的特性、功能和部署说明需要以易于遵循的格式记录和呈现。 获得正确的 API 文档势在必行,这正是 Theneo 希望取得成功的地方。

来自 Theneo 的示例 API 文档。 图片来源: 西尼奥

类似条纹的 API 文档

Theneo 的联合创始人兼首席执行官 Ana Robakidze 表示,她曾在领导工程团队的职位上研究过数百个 API,并得出结论认为通常缺乏高质量的 API 文档。

“我亲眼目睹了 API 文档对我们项目的交付、成本和效率的影响,”Robakidze 说。 “因此,作为团队负责人,我花费了大量的时间和精力来寻找一种可以帮助我们创建出色的 API 文档的工具——类似于 Stripe 所拥有的,因为它被认为是业内最好的工具之一. 大多数工具的问题在于它们要么很耗时,要么有太多限制。”

根据 Robakidze 的说法,问题的根源在于开发人员不一定是技术作家——他们更愿意“创建另一个 API 而不是记录它,”她说。 因此,许多专门的内部 API(即为连接公司内部系统和应用程序而构建的 API)要么完全没有文档记录,要么如果它们有文档记录,则随着 API 的发展没有同步和维护。 随着开发人员在公司内部来来去去,这个问题变得更加复杂,通常会导致难以处理的混乱。

“Theneo 是在挫折中创建的,目的是让高质量的 API 文档快速生成,并且易于维护,”Robakidze 说。

使用 Theneo,开发人员可以连接他们的 GitHub 存储库或上传他们的 API 集合,然后 Theneo 会分析所有内容并提供所需的 API 文档。 它还提供了一个使用自然语言处理 (NLP) 来改进文档的 AI 助手,包括自动描述不同的 API 属性,这些属性基本上是 API 规范中开发人员需要请求、发送和删除数据等的部分. 因此,例如,“创建客户”对象包含各种属性,每个属性都有一个定义,以便用户(即开发人员)确切地知道该属性的用途。

“我们的 AI 助手会为这些字段开发描述,这通常需要开发人员或技术作家花费大量时间来创建,尤其是当您的 API 中有数千个字段时,”Robakidze 解释说。

Theneo:显示字段/属性描述的示例 API 文档。 图片来源: 西尼奥

虽然 Theneo 旨在尽可能地自动化该过程,但它显然不会完全出于自己的意愿提供包装好的 API 文档——它承认开发人员和其他团队成员将需要微调格式和措辞,添加更多图像或任何它需要的东西。

“我们分析 API,解析它,然后返回一个结构良好的 API 文档,”Robakidze 说。 “然后,用户可以选择是否添加更多细节,例如图像和不同的 API 小部件,并添加团队成员以便他们进行协作。”

虽然支持 Theneo 的引擎在内部和外部 API 中是相同的,但该公司为后者提供了额外的工具,承认第三方开发人员喜欢更容易遵循的更流畅的界面。 所以这基本上相当于一种白标产品,可以根据公司的要求进行定制和品牌化。

在定价方面,Theneo 目前有一个基本计划,每位用户每月花费 20 美元左右,商业计划中无限 API 项目的费用增加到每月 45 美元。 它还提供了一个企业计划,可以解锁定制品牌和自我托管等功能。 它还在开发一个完全免费的版本,尽管 Robakidze 说这还没有准备好迎接黄金时段。

Theneo 联合创始人兼首席执行官 Ana Robakidze。

资金

自一年前成立以来,Y Combinator (YC) 毕业生已经筹集了 150 万美元的种子前资金,本周证实它正在筹集更多资金。 它还推出了一个更新的文档编辑器,Robakidze 将其描述为类似于“API 的 Figma”,专为参与软件项目的每个人提供贡献,无论他们的技术实力如何。

“我们意识到在构建 API 或 API 文档方面有多个参与者,而这些用户的协作至关重要,”Robakidze 解释说。 “与 Figma 在协作方面所做的类似,我们的 API 文档编辑器允许用户进行协作,因此管理人员和非技术成员可以轻松地在内容上协作并生成高质量的文档。”

Robakidze 表示,该公司非常愿意与任何规模和类型的企业合作,目前与大约 3,000 家公司合作,涵盖从金融科技和政府机构到农业公司的所有领域。

“我们最大的客户是金融科技公司,通常有 20 多名开发人员,”Robakidze 说。

鉴于 Theneo 希望效仿过去十年中出现的最大的金融科技初创公司之一,Theneo 在金融科技领域看到了特别的吸引力,这在某种程度上是合适的。 Stripe 以其被初创公司和大型科技公司(包括谷歌和亚马逊)使用的支付处理 API 而闻名,它提供的文档在开发人员喜欢它的原因中发挥了作用。

“我喜欢进行 Stripe 集成的一个原因是因为他们的 API 文档组织得非常好,有一个经过深思熟虑的用户界面,并且通常使开发人员可以轻松获取与他们集成所需的信息,”罗巴基泽说。 “当我在研究其他 Stripe 替代品时,我通常会花费两倍的时间,因为浏览和定位必要的 API 信息非常具有挑战性。 开发人员喜欢 Stripe 的 API 文档,因此我们希望确保其他企业和开发人员能够生成相同的高质量文档。”

#Theneo #想为所有开发者带来类似 #Stripe #的 #API #文档

Leave a Reply

Your email address will not be published. Required fields are marked *