Bibliothèques clientes et expérience développeur : bilan de l’année

Si l’expression expérience développeur est encore assez inhabituelle, on constate néanmoins que cet aspect suscite un intérêt croissant depuis plus d’une dizaine d’années. 

Rien d’étonnant, vu la complexité des projets logiciels à l’heure actuelle. Pour remédier à cela, il est souvent nécessaire de créer des outils et des ressources annexes : documentation, tutoriels, exemples de codes, forums, soutien technique... 

Notre API étant utilisée par des dizaines de milliers de personnes dans le monde, nous nous devons d’accorder une attention toute particulière à cette expérience développeur. Voici donc un petit récapitulatif de nos réalisations de l’année, de même qu’un aperçu des projets à venir. 

Bibliothèques clientes

Les bibliothèques clientes sont au cœur de notre expérience développeur, car elles permettent à leurs utilisateurs de créer rapidement des codes dans des environnements qu’ils maîtrisent déjà. 

Ces bibliothèques sont les premiers projets de DeepL offerts en source ouverte. Les développeurs peuvent donc les personnaliser à loisir et nous envoyer leurs commentaires directement.

Notre bibliothèque Python a ouvert la voie en août 2021, avant d’être suivie par celles en langages .NET, Node.js, PHP, puis Java. En un an, ces bibliothèques ont été employées au moins une fois par des milliers d’utilisateurs, et représentaient environ 7 % de toutes les requêtes API (soit des milliards de caractères).  

Nous avons l’intention d’ajouter au moins une bibliothèque supplémentaire sur Go cette année, tout en poursuivant l’amélioration de celles que nous avons déjà mises en ligne.  

Nos bibliothèques vous inspirent des idées ou des commentaires ? Rendez‑vous sur GitHub et faites‑nous‑en part en créant un ticket dans le référentiel correspondant. Sachez que nous gardons aussi un œil sur le mot‑clé #deepl sur Stack Overflow.

Spécifications OpenAPI

En juin dernier, nous avons publié des spécifications OpenAPI destinées à l’API de DeepL (en anglais). Grâce à elles, vous pouvez non seulement générer des bibliothèques dans les langages de programmation que nous ne prenons pas encore en charge, mais aussi utiliser notre API dans Swagger UI et Postman. Plus généralement, ces spécifications nous permettent aussi d’assurer la cohérence et l’efficacité de notre documentation ; elles ont d’ailleurs inspiré la réécriture de cette même documentation, dont la mise à jour devrait être facilitée dorénavant.  

Veuillez noter que nous avons l’intention d’ajouter des exemples de codes dans notre documentation, en plus de ceux de type cURL et HTTP qui s’y trouvent déjà. 

Consultez nos spécifications OpenAPI sur GitHub (en anglais)

Exemples de projets API

Tout au long de l’année, de nombreux utilisateurs nous ont signalé qu’ils aimeraient avoir accès à davantage d’exemples pour s’en inspirer lorsqu’ils utilisent l’API de DeepL, ou encore pour les intégrer aux premiers stades de leurs projets. Ce fut chose faite en août 2022, lorsque nous avons mis en ligne notre premier exemple de projet, à savoir un script pour Google Sheets permettant de traduire le contenu des cellules de votre fichier. Tout comme les autres projets GitHub de DeepL, cet exemple est en source ouverte sous licence MIT. 

Nous espérons bien qu’il sera le premier d’une longue série, même si nous ne savons pas encore exactement quels seront les prochains. Comme d’habitude, faites‑nous part de vos commentaires en créant un ticket sur GitHub.  

N’hésitez pas à nous dire ce que vous pensez de l’expérience développeur proposée par DeepL. Sachez également que nous ferons bien entendu notre possible afin de perfectionner notre API en proposant de nouvelles langues et de nouvelles fonctionnalités, et en poursuivant l’extension de la fonction glossaire. 

Vous souhaitez découvrir l’API de DeepL ? Inscrivez‑vous pour traduire gratuitement jusqu’à 500 000 caractères par mois.

Points essentiels

1. Depuis sa mise en ligne en août 2021, notre première bibliothèque (Python) a été utilisée des milliers de fois, aussi bien dans la version gratuite que payante de DeepL. 
2. DeepL a également mis en ligne des bibliothèques en langages .NET, Node.js, PHP et Java, de même que des spécifications OpenAPI. 
3. Nous continuerons d’améliorer l’expérience développeur en peaufinant notre documentation et en proposant de nouvelles bibliothèques ainsi que d’autres exemples de codes.