In che modo un approccio API-first sta plasmando il futuro di Zonos

Cos'è un approccio API-first? 

L'approccio API-first è in netto contrasto con l'approccio code-first, in cui un team inizia progettando le funzionalità dell'applicazione, scrivendo il codice e aggiungendo le API solo alla fine del processo.

In Zonos, sviluppare software con un approccio API-first significa progettare le soluzioni attorno a un'API, anziché scrivere il codice di un'applicazione e aggiungere un'API in un secondo momento. Questo significa che le nostre API sono fondamentali e costituiscono prodotti a sé stanti: le progettiamo concentrandoci intensamente sulle esigenze del cliente e le documentiamo e architettiamo chiaramente prima di scrivere qualsiasi riga di codice.

I vantaggi di un approccio API-first 

L'approccio API-first aiuta a instaurare la seguente mentalità:

• Comprendiamo che le nostre API sono l'interfaccia principale per i nostri clienti e, per questo, le consideriamo i nostri prodotti pubblici.
• Documentare prima di scrivere il codice ci dà l'opportunità di ragionare, discutere, perfezionare e comunicare i nostri obiettivi con i team e gli stakeholder, per creare un prodotto finale migliore.
• Concentrandoci sulle esigenze dei nostri clienti, comprendiamo qual è il modo migliore per progettare API che le soddisfino.

Questa mentalità mette al primo posto le nostre API e i nostri clienti ed è fondamentale per costruire una base in cui tutti, in Zonos, sono responsabili del successo dei clienti.

I team di sviluppo possono lavorare in parallelo

L'approccio API-first prevede la definizione di un contratto. La creazione di un contratto tra servizi, seguito dai team in tutta l'organizzazione, consente a tali team di lavorare contemporaneamente su più API. Gli sviluppatori non devono attendere il rilascio degli aggiornamenti di un'API prima di passare alla successiva. I team possono testare simultaneamente le API e le relative dipendenze tramite mock, basandosi su definizioni API prestabilite.

Riduce i costi di sviluppo

Le API e il codice possono essere riutilizzati in molti progetti diversi. Con l'approccio API-first, se un team di sviluppo vuole creare una nuova applicazione, non deve partire da zero, risparmiando tempo e denaro. La progettazione API-first consente inoltre di risolvere la maggior parte dei problemi ancor prima di scrivere il codice, il che aiuta a prevenire complicazioni al momento di integrare le API con le applicazioni.

Aumenta la velocità di immissione sul mercato

Gran parte del processo di creazione delle API può essere automatizzata utilizzando strumenti che importano i file di definizione delle API. Iniziamo generando i tipi, le definizioni e gli schemi principali; a partire da questi file è possibile generare automaticamente strumenti come la documentazione delle API, i kit di sviluppo software (SDK) e le API mock. L'automazione accelera notevolmente lo sviluppo di API e applicazioni.

L'approccio API-first rende inoltre possibile aggiungere nuovi servizi e tecnologie alle applicazioni senza dover riprogettare l'intera architettura del sistema. Zonos deve rilasciare rapidamente le funzionalità in produzione per rimanere competitiva nel mercato SaaS cross-border in continua evoluzione. È più facile eliminare il debito tecnico nel codice sottostante che migrare i clienti lontano da un'API progettata male.

Garantisce una buona esperienza per gli sviluppatori

Chi utilizza le API è spesso uno sviluppatore, e l'esperienza dello sviluppatore (DX, developer experience) può determinare il successo o il fallimento di un'API. L'approccio API-first garantisce un'esperienza dello sviluppatore positiva, perché un'API ben progettata, ben documentata e coerente è più facile da apprendere e riutilizzare. Questo aumenta anche la velocità di implementazione. Tutti questi vantaggi sono interconnessi!

Aumenta il successo a lungo termine

Un approccio API-first consente di prototipare e iterare rapidamente, il che significa che impariamo più in fretta cosa funziona e cosa no. Come i 1.000 tentativi falliti di Edison prima di inventare la lampadina, l'approccio API-first significa fallire velocemente e andare avanti con una comprensione migliore di come raggiungere il successo. L'approccio API-first aumenta il nostro successo a lungo termine, garantendo che le API siano affidabili, coerenti e facili da usare per gli sviluppatori.

Perché lavorare a ritroso è efficace? 

Nel 2015 ho avuto l'opportunità di riprogettare il sito e-commerce di un noto marchio di largo consumo. Ho valutato vari indicatori chiave di prestazione (KPI, key performance indicator) relativi al sistema esistente, ed era chiaro dove si potessero ottenere i maggiori miglioramenti:

• Il tasso di conversione da desktop era al di sotto degli standard.
• Il tasso di conversione da mobile era pessimo.
• La percentuale di traffico da mobile stava aumentando rapidamente e avrebbe superato il 50% del traffico totale entro i successivi 12 mesi. A causa del pessimo tasso di conversione da mobile, il fatto che la maggior parte del traffico provenisse da dispositivi mobili non era l'ideale.

Considerati i dati, cosa avrebbe creato il massimo valore per gli utenti? Era ovvio: risolvere i problemi legati all'esperienza utente da mobile del sito. Ho quindi adottato un approccio mobile-first per riprogettare il sito. Questo significava che tutti i design, l'architettura, le API, ecc. tenevano conto per prima cosa dell'esperienza mobile. Era l'opposto dell'approccio tradizionale dell'epoca, che si concentrava innanzitutto sull'esperienza desktop, lasciando spesso l'esperienza mobile come un ripensamento aggiunto in modo maldestro, con tassi di conversione scarsi. L'approccio mobile-first richiedeva anche uno sforzo iniziale maggiore: non era la strada più semplice. Era necessaria una nuova architettura, andavano scritte nuove API ed erano richiesti più design per ogni breakpoint.

L'approccio mobile-first ha portato a un aumento significativo del tasso di conversione da mobile. La nuova architettura ha inoltre generato miglioramenti notevoli nel tasso di conversione da desktop. L'approccio ha avuto successo perché ha individuato come creare il massimo valore per l'utente e ha concentrato l'intero approccio sulla fornitura di quel valore. Ha creato la mentalità giusta fin dall'inizio. Allo stesso modo — anche se può sembrare un lavoro a ritroso — un approccio API-first crea l'opportunità di individuare i problemi generali e poi costruire una base per correggerli.

Qual è la responsabilità dell'ingegneria? 

La mentalità API-first ha guidato e continuerà a guidare Zonos verso il successo, e l'ingegneria svolge un ruolo fondamentale in questo. È nostra responsabilità mantenere sempre la mentalità API-first. Questo significa che ci poniamo costantemente domande che mantengono l'attenzione sulle nostre API, come ad esempio: «In che modo le nostre API possono soddisfare le esigenze del cliente» Significa anche che rispondiamo sempre alle domande su funzionalità e caratteristiche con un link alla nostra documentazione delle API. Se la documentazione non esiste, la creiamo, lavorando insieme in team cross-funzionali per garantire che Zonos disponga di una documentazione delle API eccellente.