Come l'approccio API sta plasmando il futuro di Zonos

Cos'è il primo approccio API? 

L'approccio API-first contrasta nettamente con l'approccio code-first, in cui un team inizia progettando la funzionalità dell'applicazione, scrivendo il codice e quindi aggiungendo API alla fine del processo.

In Zonos, sviluppare software con un approccio API significa progettare soluzioni attorno a uno API, piuttosto che codificare un'applicazione e aggiungere uno API in un secondo momento. Ciò significa che i nostri API sono fondamentali e sono prodotti a sé stanti; Li progettiamo prestando particolare attenzione alle esigenze dei clienti e li documentiamo e progettiamo chiaramente prima di scrivere qualsiasi codice.

I vantaggi di un approccio API-first 

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

• Comprendiamo che i nostri API rappresentano l'interfaccia principale per i nostri clienti e pertanto li consideriamo i nostri risultati pubblici.
• Documentare prima di scrivere il codice ci dà l'opportunità di ragionare, discutere, perfezionare e comunicare i nostri obiettivi con i nostri team e le parti interessate per creare un prodotto finale migliore.
• Concentrandoci sulle esigenze dei nostri clienti, comprendiamo come progettare al meglio gli API che soddisfino tali esigenze.

Questa mentalità mette al primo posto il nostro API e i nostri clienti ed è fondamentale per stabilire una base in cui tutti in Zonos siano responsabili del successo dei clienti.

I team di sviluppo possono lavorare in parallelo

Il primo approccio API prevede la stipula di un contratto. La creazione di un contratto di servizi incrociati seguito dai team di un'organizzazione consente a tali team di lavorare su più API contemporaneamente. Gli sviluppatori non devono attendere il rilascio degli aggiornamenti API prima di passare al successivo API. I team possono simulare e testare simultaneamente le dipendenze API e API sulla base di definizioni API prestabilite.

Ridurre i costi di sviluppo

API e il codice possono essere riutilizzati in molti progetti diversi. Con l'approccio API-first, se un team di sviluppo desidera creare una nuova applicazione, non è necessario iniziare da zero, il che consente di risparmiare tempo e denaro. Il design API-first consente inoltre di risolvere la maggior parte dei problemi prima di scrivere qualsiasi codice, contribuendo a prevenire problemi quando arriva il momento di integrare API con le applicazioni.

Aumentare la velocità di commercializzazione

Gran parte del processo di creazione API può essere automatizzato utilizzando strumenti per importare file di definizione API. Iniziamo generando i principali tipi, definizioni e schemi; Con questi file, è possibile generare automaticamente strumenti API come la documentazione API, kit di sviluppo software (SDK) e API simulati. L'automazione accelera notevolmente lo sviluppo di API e delle applicazioni.

API-first consente inoltre di aggiungere nuovi servizi e tecnologie alle applicazioni senza dover ristrutturare l'intero sistema. Zonos deve spedire rapidamente le funzionalità alla produzione per rimanere competitivo nel mercato SaaS transfrontaliero in continua evoluzione. È più semplice eliminare il debito tecnico nel codice sottostante piuttosto che migrare i clienti da uno API mal progettato.

Garantisci buone esperienze agli sviluppatori

I consumatori di API sono in genere sviluppatori e l'esperienza dello sviluppatore (DX) può determinare il successo o il fallimento di uno API. L'approccio API-first garantisce che l'esperienza dello sviluppatore sia positiva perché uno API ben progettato, ben documentato e coerente è più facile da apprendere e riutilizzare. Ciò aumenta anche la velocità di distribuzione. Tutti questi vantaggi sono interconnessi!

Aumentare il successo a lungo termine

Un approccio API-first consente una rapida prototipazione e iterazione, il che significa che impariamo più velocemente cosa funziona e cosa no. Come i 1.000 tentativi falliti di Edison prima di creare la lampadina, API-first significa che falliamo velocemente e andiamo avanti con una migliore comprensione di come avere successo. API-first aumenta il nostro successo a lungo termine garantendo che gli API siano affidabili, coerenti e adatti agli sviluppatori.

Perché lavorare all’indietro è efficace? 

Nel 2015 ho avuto l'opportunità di riprogettare il sito e-commerce di un noto marchio di consumo. Ho valutato diversi indicatori chiave di prestazione (KPI) relativi al sistema esistente ed è diventato chiaro dove si potevano ottenere i maggiori miglioramenti:

• Il tasso di conversione su desktop era scarso.
• Il tasso di conversione da dispositivo mobile era spaventoso.
• La percentuale del traffico mobile stava aumentando rapidamente e avrebbe superato il 50% del traffico totale nei prossimi 12 mesi. A causa del pessimo tasso di conversione da dispositivi mobili, avere la maggior parte del traffico proveniente da dispositivi mobili non era l’ideale.

Considerati i dati, cosa creerebbe il massimo valore per gli utenti? È stato un gioco da ragazzi: risolvere i problemi relativi all'esperienza utente mobile del sito. Pertanto, ho adottato un approccio mobile-first per riprogettare il sito. Ciò significa che tutti i progetti, l'architettura, gli API, ecc., hanno considerato innanzitutto l'esperienza mobile. Questo era l’opposto dell’approccio tradizionale dell’epoca, che si concentrava innanzitutto sull’esperienza desktop, spesso lasciando l’esperienza mobile come un goffo componente aggiuntivo con bassi tassi di conversione. L’approccio mobile-first ha richiesto anche uno sforzo iniziale maggiore: non era la strada facile. Era necessaria una nuova architettura, sarebbero stati scritti nuovi API e sarebbero stati necessari più progetti per ciascun punto di interruzione.

L’approccio mobile-first ha portato ad un aumento significativo del tasso di conversione mobile. La nuova architettura ha prodotto anche notevoli miglioramenti nel tasso di conversione del desktop. L'approccio ha avuto successo perché ha identificato come creare il massimo valore per l'utente e ha focalizzato tutta l'attenzione sulla fornitura di tale valore. Ha creato la mentalità giusta fin dall'inizio. Allo stesso modo, anche se può sembrare un lavoro a ritroso, un approccio basato su API crea opportunità per identificare problemi generali e quindi costruire le basi per correggerli.

Qual è la responsabilità dell'ingegneria? 

La mentalità API-first ha portato e continuerà a portare Zonos al successo e l'ingegneria gioca un ruolo fondamentale. È nostra responsabilità mantenere sempre la mentalità API-first. Ciò significa che poniamo costantemente domande che mantengono l'attenzione sui nostri API, ad esempio: "In che modalità il nostro API può soddisfare le esigenze dei clienti?" Significa anche che rispondiamo sempre alle domande su caratteristiche e funzionalità con un collegamento alla nostra documentazione API. Se la documentazione non esiste, la creiamo, lavorando insieme in team interfunzionali per garantire che Zonos disponga di un'eccellente documentazione API.