Gateway API
Orbita
Un gateway che tiene insieme e-commerce e corrieri, e mostra cosa sta succedendo mentre succede.
Demo parziale del prodotto: dati di esempio, restano nel tuo browser.
- Ruolo
- Architettura, API e interfaccia
- Anno
- 2024
- Per chi
- Operatore logistico per e-commerce
- Tecnologie
- Node.jsRedisAWS
Il punto di partenza
Le API dei corrieri vanno giù, rispondono 429, cambiano formato senza avvisare. Chi integra passa il tempo a leggere log per capire se il problema è suo o loro.
Orbita normalizza le risposte, gestisce i tentativi e soprattutto fa vedere cosa è andato storto senza aprire un terminale.
Console live
Il flusso delle richieste mentre arrivano. Le colonne sono allineate col monospazio, così l'occhio trova l'anomalia senza leggere: l'unico colore di ogni riga è il codice di stato.
Dettaglio di una rotta
Cosa fa Orbita quando il corriere risponde male: limite di richieste, tentativi con attesa crescente e la traduzione dei campi, accanto alla risposta reale.
Latenza e errori
Tre percentili sono una scala, non tre categorie: una sola tinta in tre gradazioni, etichette sulle linee invece della legenda lontana, un asse solo. Sotto, dove si concentrano gli errori.
Demo funzionante
Un gateway con traffico simulato che reagisce a ogni modifica: rotte, chiavi, webhook, avvisi.
- Segui le richieste in tempo reale, apri una richiesta e ritentala, esporta il log in CSV.
- Spegni una rotta e guarda comparire i 404; alza un limite e i 429 spariscono. Crea una chiave API e revocala.
- Aggiungi un webhook, manda un evento di prova, riprova una consegna fallita. Gli avvisi scattano quando p95 ed errori superano le soglie.
Versione limitata: i dati sono di esempio e restano nel tuo browser.
Scelte progettuali
Il monospazio qui non è uno stile
Percorsi, codici di stato e tempi stanno in colonne allineate: con i caratteri a larghezza fissa l'occhio trova subito l'anomalia nella colonna.
Gli errori si leggono in periferia
Lo stato è l'unico elemento colorato di ogni riga. Guardando lo schermo di sfuggita si nota il giallo di un 429 senza leggere nulla.
Grafici che rispondono a una domanda
Un solo asse, tre percentili e nessuna area sfumata decorativa: il grafico serve a capire se la lentezza riguarda tutti o solo la coda.