DeepL Logo

DeepL API客户端库以及开发人员体验:年度回顾

开发人员体验在企业词典中还是比较新的概念。然而,在过去的十几年中,人们对软件开发人员用户体验的兴趣却在持续增长。 

原因显而易见。现代软件项目往往十分复杂,要降低该复杂性,就需要为开发者投资核心产品以外的工具和资源:从文档、教程、代码样本,到社区以及新的支持渠道。 

作为一家为全球数以万计的用户提供API的公司,我们格外重视开发人员经验。因此,我们想分享我们在过去一年中的发展,以及我们对未来的规划。 

API客户端库

客户端库是我们开发者体验工作的核心。用户得以在他们熟悉的系统中工作,以编写更简单、更有效的代码。 

客户端库是DeepL发布的第一批开源项目。开放源代码使用户更容易定制客户端库,并直接与我们分享反馈。

自从我们在2021年8月发布了第一个Python客户端库后,我们相继发布了.NET、Node.js、PHP和Java库。仅仅一年后,即2022年8月,所有DeepL API请求(相当于数十亿的翻译字符)中约有7%是通过我们的客户端库进行的。成千上万的API用户至少在一次API请求中使用了客户库。 

在未来的一年里,我们计划至少再增加一个Go语言的客户端库。随着API不断增加新的功能,我们将持续更新我们现有的客户端库。  

你有任何与我们的客户库相关的想法或反馈吗?请在相应的存储库中创建一个GitHub问题,并开始对话。我们通过Stack Overflow检测含有#deepl的标签

OpenAPI使用规范

2022年6月,我们为DeepL API发布了OpenAPI使用规范。该规范不仅使用户更容易为尚未被DeepL支持的编程语言生成客户端,而且可以指导他们使用Swagger UI或Postman探索API。该规范还将帮助DeepL团队更容易一致和有效地维护文件。近期,我们在OpenAPI规范的基础上重写了我们的技术文件,这有助于我们对未来文件的改进。  

例如,我们计划在技术文件中增加客户端库的代码实例,以补充现有的cURL和HTTP实例。 

你可以在GitHub中此处查看OpenAPI .

API示例项目

在过去的一年里,我们时常收到用户的反馈——他们希望看到更多的示例,作为个人项目的起点,或在整合DeepL API时进行参考。在2022年8月,我们为DeepL API发布了有史以来第一个示例项目——用DeepL翻译谷歌表格示例脚本中的单元格。同于其他GitHub项目,该示例项目在MIT许可下是开源的。 

我们目前仍在计划未来的样本项目发布。因此,谷歌表格脚本仅仅是个开始。我们一如既往地期待用户的反馈!  

如果你有任何对我们的开发者体验工作的反馈意见,请给我们留言。我们还将持续致力于研发新的API功能、发布更多语言并在术语表功能中添加更多语言对。 

初次接触DeepL API,你准备好了吗?注册DeepL,每月可免费翻译多达50万个字符。


结语:

  1. 自2021年8月我们发布了第一个Python语言的API客户端库之后,该库为成千上万的Free和Pro API用户所使用。 
  2. 除了Python之外,我们还发布了.NET、Node.js、PHP和Java的客户端库,以及OpenAPI规范。 
  3. 我们将继续通过提供更多的客户端库、简化的技术文件和更多的代码样本来改善开发者体验。