Bibliotecas de cliente da API do DeepL e experiência dos programadores: uma retrospectiva do ano

Ainda que o conceito de experiência do programador seja algo ainda relativamente novo no mundo corporativo, o interesse pela experiência do usuário por parte dos desenvolvedores de software vem crescendo cada vez mais ao longo da última década. 

E não é difícil entender o porquê. Os projetos de software mais modernos podem ser bastante complexos e minuciosos. Por isso, buscamos minimizar esta complexidade ao investir em uma variedade de ferramentas e recursos para programadores que vão além do produto principal: desde documentação até tutoriais, passando por exemplos de código, comunidades e novos canais de suporte. 

Para uma empresa como o DeepL, que fornece um serviço de API a dezenas de milhares de usuários em todo o mundo, a experiência dos programadores tem prioridade absoluta. É por esse motivo que gostaríamos de compartilhar uma breve retrospectiva do que fizemos nesse sentido durante o ano que passou, bem como apresentar alguns dos planos que temos para o futuro. 

Bibliotecas de cliente da API

As bibliotecas de cliente são um elemento fundamental para garantir uma boa experiência de usuário por parte dos programadores, pois elas permitem que eles trabalhem em um sistema conhecido e criem códigos de forma mais fácil e eficiente. 

Essas bibliotecas foram os primeiros projetos de código aberto criados pelo DeepL. Com este tipo de projeto, os usuários podem facilmente personalizar as bibliotecas de acordo com suas preferências e ainda nos enviar feedback diretamente.

Criamos nossa primeira biblioteca de cliente em linguagem Python em agosto de 2021 e, desde então, lançamos bibliotecas em .NET, Node.js, PHP, e Java. Um ano depois, começamos a ver os primeiros resultados desses lançamentos: cerca de 7% dos pedidos da API do DeepL (o que representa um volume de caracteres traduzidos na casa dos bilhões) haviam sido realizados através de uma das nossas bibliotecas de cliente, e milhares de usuários da API já tinham feito pelo menos um pedido usando uma biblioteca de clientes.  

Para o ano que vem, temos planos de incluir pelo menos mais uma biblioteca de cliente em linguagem Go, e continuaremos a atualizar nossas bibliotecas de cliente já disponíveis à medida que nossa API for adquirindo novas funcionalidades.   

Você tem um comentário ou gostaria de sugerir novas funcionalidades para as nossas bibliotecas de cliente? Crie um pedido (issue) no GitHub através do repositório correspondente e envie sua mensagem. Além desse canal, estamos sempre acompanhando os posts com a hashtag #deepl enviados no Stack Overflow.

Especificação OpenAPI

Em junho de 2022, publicamos uma especificação no formato OpenAPI para a API do DeepL. Assim, é possível não apenas gerar bibliotecas em linguagens de programação não compatíveis com o DeepL, mas também usar nossa API em ferramentas como Swagger UI e Postman. Essa especificação também ajuda a equipe do DeepL a manter a documentação da API sempre em dia. Recentemente atualizamos nossa documentação com base na especificação OpenAPI, para que possamos continuar a desenvolvê-la no futuro de uma maneira mais fácil e eficaz.  

Uma das melhorias que planejamos implementar nas documentações são exemplos de códigos para as bibliotecas de cliente, o que vem para complementar os exemplos de cURL e HTTP já existentes. 

Para saber mais sobre nossa especificação OpenAPI no GitHub, clique aqui (conteúdo disponível apenas em inglês).

Exemplos de projetos com a API

Durante o último ano, um pedido recorrente por parte de nossos usuários foi de exemplos de projetos usando a API do DeepL, seja para integrá-los nas fases iniciais de seus próprios projetos ou para usá-los como fonte de inspiração e referência. Foi por isso que em agosto publicamos nosso primeiro projeto de exemplo com a API do DeepL: um script para o Google Sheets que permite a tradução do conteúdo das células usando o DeepL. Assim como outros projetos nossos no GitHub, este modelo de projeto é de código aberto e possui a licença MIT. 

Esperamos que este seja o primeiro de muitos dos exemplos de projetos que compartilharemos no GitHub, mesmo que estejamos ainda esboçando os próximos passos nesse sentido. Ideias, críticas e sugestões sobre o desenvolvimento dos nossos serviços são, como sempre, muito bem-vindas.  

Para falar conosco a respeito, envie-nos um ticket no GitHub. Continuamos trabalhando para ampliar o número de funcionalidades, idiomas e combinações do glossário na API do DeepL. 

Ainda nunca usou a API do DeepL, mas gostaria de começar? Cadastre-se para traduzir até 500.000 caracteres por mês de graça.

Resumindo:

1. Lançamos nossa primeira biblioteca de cliente da API em Python em agosto de 2021 e, desde então, ela tem sido utilizada por milhares de usuários das versões DeepL API Free e DeepL API Pro. 
2. Além da versão em Python, lançamos bibliotecas de clientes em .NET, Node.js, PHP e Java - bem como uma especificação OpenAPI. 
3. Continuaremos a trabalhar para aprimorar ainda mais a experiência do programador através de novas bibliotecas de cliente, melhorias na documentação e outros exemplos de código.