Biblioteki klienta DeepL API i developer experience: podsumowanie roku

author DeepL Team

Doświadczenie programisty (ang. developer experience) to stosunkowo nowe pojęcie w świecie biznesu, jednak w ciągu ostatniej dekady jego popularność wyraźnie wzrasta. 

Przyczyny są oczywiste: nowoczesne projekty programistyczne potrafią być niezwykle skomplikowane. Aby sprostać wszystkim wyzwaniom, firmy zmuszone są inwestować nie tylko w podstawowy produkt, ale również w dodatkowe zasoby i narzędzia, takie jak dokumentacja, samouczki, przykłady kodu, społeczności oraz nowe kanały wsparcia. 

Z naszego interfejsu API korzystają już dziesiątki tysięcy użytkowników na całym świecie, dlatego chcemy zapewnić im jak największy komfort pracy. W tym wpisie chcielibyśmy podsumować nasze działania z tym związane, a także opowiedzieć o planach na przyszłość. 

Biblioteki klienta API

Udostępnienie bibliotek klienta stanowi dla nas najważniejszy element działań mających na celu poprawę doświadczeń programistów. To dzięki nim użytkownicy mogą pisać prostszy i bardziej wydajny kod w systemie, który już znają. 

Biblioteki klienta to pierwsza grupa projektów o otwartym dostępie do kodu źródłowego (ang. open source), które zaczęto realizować w DeepL. Otwarty dostęp do kodu źródłowego ułatwia użytkownikom dostosowanie bibliotek do swoich potrzeb oraz bezpośrednie przesyłanie nam informacji zwrotnych.

W sierpniu 2021 r. udostępniliśmy pierwszą bibliotekę klienta dla Pythona. Od tego czasu pojawiły się również wersje dla .NET, Node.js, PHP i Javy. W sierpniu 2022 r. już około 7% żądań do interfejsu API DeepL (co odpowiada miliardom przetłumaczonych znaków) zostało wykonanych przy użyciu naszych bibliotek klienta. Tysiące użytkowników API wysłało z ich pomocą przynajmniej jedno żądanie.  

W tym roku zamierzamy dodać przynajmniej jedną bibliotekę dla języka Go. Chcemy również kontynuować aktualizację wszystkich pozostałych, aby obsługiwały nowe funkcje API.  

Czy masz sugestie dotyczące naszych bibliotek klienta? A może chcesz podzielić się z nami swoją opinią? Utwórz zgłoszenie w GitHubie w odpowiednim repozytorium, aby rozpocząć konwersację. Jesteśmy również otwarci na wszelkie komentarze. Można je zamieścić w serwisie Stack Overflow, używając hashtagu #deepl.

Specyfikacja OpenAPI

W czerwcu 2022 r. opublikowaliśmy specyfikację OpenAPI dla interfejsu API DeepL. Ułatwia ona tworzenie bibliotek klienta dla języków programowania, które nie są jeszcze obsługiwane przez DeepL, oraz pracę z API za pomocą takich narzędzi jak Swagger UI lub Postman. Wspomniana specyfikacja umożliwi również zespołowi DeepL prowadzenie dokumentacji API w sposób spójny i efektywny. Pragnąc ułatwić proces udoskonalania dokumentacji w przyszłości, zaktualizowaliśmy ją w oparciu o specyfikację OpenAPI.  

Planujemy też dodać do niej próbki kodów dla bibliotek klienta. Będą one stanowić uzupełnienie przykładów, które już udostępniliśmy dla cURL i HTTP. 

Jeżeli chcesz zapoznać się ze specyfikacją OpenAPI, odwiedź serwis GitHub.

Przykładowe projekty z wykorzystaniem interfejsu API

W ciągu ostatniego roku otrzymaliśmy od naszych użytkowników wiele próśb o przykłady, które mogłyby stanowić inspirację podczas pracy z naszym interfejsem API. Postanowiliśmy spełnić te życzenia. Już w sierpniu 2022 r. opublikowaliśmy nasz pierwszy przykładowy projekt dla API DeepL – skrypt dla Google Sheets, który umożliwia tłumaczenie zawartości komórek za pomocą DeepL. Jest to projekt open source na licencji MIT (podobnie jak pozostałe, które opublikowaliśmy na GitHubie). 

Obecnie zajmujemy się planowaniem kolejnych przykładów, które będziemy mogli udostępnić w serwisie GitHub. Jeżeli masz jakiekolwiek uwagi lub sugestie, poinformuj nas o tym za pomocą zgłoszenia na GitHubie.  

Pragniemy też poznać Twoją opinię na temat naszych działań w zakresie poprawy doświadczeń programistów. Wciąż pracujemy nad ulepszeniem naszego API, udostępniając kolejne języki i opcje oraz dodając nowe pary językowe do funkcji Glosariusza. 

Chcesz rozpocząć korzystanie z DeepL API? Zarejestruj się już teraz i uzyskaj możliwość tłumaczenia aż do 500 000 znaków miesięcznie za darmo.


Podsumowanie:

  1. W sierpniu 2021 r. udostępniliśmy naszą pierwszą bibliotekę klienta API dla Pythona i od tego czasu korzystają z niej tysiące abonentów DeepL API Free i DeepL API Pro. 

  2. Opublikowaliśmy również biblioteki dla .NET, Node.js, PHP i Javy, a także specyfikację OpenAPI. 

  3. Zamierzamy nadal pracować nad poprawą doświadczeń programistów poprzez udostępnianie nowych bibliotek klienta, uzupełnianie dokumentacji i publikowanie przykładów kodu.