Librerie client API ed esperienza utente: un riepilogo del nostro anno

Nonostante questo concetto sia ancora relativamente nuovo nel vocabolario delle aziende, l’interesse per l’esperienza utente degli sviluppatori di software è cresciuto notevolmente nell’ultimo decennio. 

Data la complessità dei progetti di sviluppo dei software, non sorprende che si investa sempre di più in strumenti e risorse che semplificano il processo per le persone coinvolte: documentazione, tutorial, esempi di codice, forum, supporto tecnico, ecc. 

Per un’azienda come DeepL, che fornisce un servizio di API a decine di migliaia di utenti in tutto il mondo, l’esperienza degli sviluppatori è una delle priorità assolute. Ecco quindi un riepilogo di ciò che siamo riusciti a realizzare nell’ultimo anno e quali sono i nostri programmi per il futuro. 

Librerie client per l’API

Le librerie client sono un elemento fondamentale per garantire un’ottima esperienza utente agli sviluppatori, in quanto consentono di lavorare in un sistema conosciuto e di scrivere codice in maniera più semplice ed efficiente. 

Le librerie client sono state il primo progetto open source creato da DeepL. L’open source permette agli sviluppatori di personalizzare le librerie come desiderano e di inviarci direttamente il loro feedback.

La nostra libreria client Python è disponibile da agosto 2021 e, da allora, abbiamo reso disponibili librerie client anche nei linguaggi .NET, Node.js, PHP e Java. In un anno, queste librerie sono state utilizzate almeno una volta da migliaia di utenti e rappresentano circa il 7% di tutte le richieste API (vale a dire miliardi di caratteri tradotti).  

Dati questi risultati, abbiamo in programma di rilasciare una libreria client Go il prossimo anno e di continuare ad aggiornare le librerie già disponibili con le nuove funzionalità offerte dalla nostra API.  

Hai qualche idea o commento sulle nostre librerie client? Crea un problema su GitHub nel repositorio corrispondente per condividere la tua opinione. Inoltre, teniamo sempre d’occhio l’hashtag #deepl su Stack Overflow, nel caso volessi lasciarci un commento lì.

Specifica OpenAPI

A giugno abbiamo pubblicato una specifica OpenAPI per l’API di DeepL. Tramite questa specifica è possibile non solo generare librerie in linguaggi di programmazione che DeepL ancora non supporta, ma anche utilizzare la nostra API con Swagger UI e Postman; consente inoltre al team di DeepL di mantenere la documentazione aggiornata in maniera efficiente. Di recente abbiamo infatti modificato la nostra documentazione tenendo in considerazione la specifica OpenAPI, in modo da facilitare gli aggiornamenti futuri.  

Una delle novità che vorremmo implementare prossimamente alla documentazione sono gli esempi di codice per le librerie client, che si aggiungeranno agli esempi di cURL e HTTP già presenti. 

Puoi trovare la specifica OpenAPI su GitHub cliccando qui.

Esempi di progetti API

Nell’ultimo anno molti dei nostri utenti hanno richiesto l’accesso a un maggior numero di esempi da cui trarre ispirazione per l'utilizzo dell'API di DeepL o da incorporare nelle prime fasi dei loro progetti. Noi li abbiamo ascoltati e, ad agosto, abbiamo pubblicato il nostro primo esempio di progetto per l’API di DeepL: uno script per Google Sheets che permette di tradurre il contenuto delle celle con DeepL. Come tutti i nostri progetti GitHub, questo script è un progetto open source con licenza MIT. 

Stiamo ancora decidendo quali saranno i prossimi esempi di progetti che condivideremo su GitHub, ma questo è solamente il primo di molti. Come sempre, se hai qualche idea o suggerimento, non esitare a creare un ticket su GitHub!  

Siamo lieti di ricevere feedback sugli sviluppi dell’esperienza utente offerta da DeepL. Continuiamo infatti a lavorare per aggiungere sempre più funzionalità, lingue e combinazioni di glossari alla nostra API. 

Non hai ancora provato l’API di DeepL? Iscriviti per tradurre fino a 500 000 caratteri al mese gratuitamente.

In conclusione

1. Abbiamo reso disponibile la nostra prima libreria client per Python nell’agosto del 2021, che è stata utilizzata da migliaia di utenti DeepL API Free e Pro. 
2. Oltre a librerie nel linguaggio Python, ne abbiamo create per i linguaggi.NET, Node.js, PHP e Java; abbiamo inoltre pubblicato una specifica OpenAPI. 
3. Continueremo a lavorare per migliorare la nostra esperienza utente, ottimizzando le librerie client, la documentazione e gli esempi di codice.