Guide
Interfacce API: processo, procedura e cosa serve da parte vostra
Il processo sul tema interfacce API dalla prima domanda all'esercizio corrente — incluso ciò che dovete contribuire voi affinché funzioni.
Un progetto di interfacce API si svolge in 4 passaggi: da «Verificare fattibilità» a «Monitorare», in totale da 2 a 6 settimane. Ogni passaggio termina con un'approvazione chiara prima che inizi il successivo.
01 — Processo
Le fasi nel dettaglio
Verificare fattibilità
C'è un'interfaccia utilizzabile su entrambi i lati? Questa è la domanda che deve avere risposta per prima.
Mappare i campi
Quale campo corrisponde a quale, e cosa succede in caso di valori mancanti.
Costruire e testare
Con dati reali, inclusi i casi che vanno male.
Monitorare
La connessione si segnala quando si blocca — prima che qualcuno se ne accorga nel lavoro quotidiano.
02 — Collaborazione
Cosa ci serve da voi
- Una persona di riferimento che possa decidere — non solo inoltrare.
- Accesso ai sistemi interessati, per tempo e non il giorno del lancio.
- Esempi reali dal quotidiano — più sono disordinati, più sono utili per il test.
- Dalle due alle quattro ore per coordinamento, distribuite sulla durata del progetto.
- Una risposta alla domanda: cosa significa successo. Senza questa, in seguito non si può valutare nulla.
03 — Ambito
Cosa è incluso
- Verifica delle interfacce esistenti di entrambi i sistemi, prima che venga promesso qualsiasi cosa
- Mappatura dei campi dati tra i sistemi, inclusi casi particolari
- Gestione degli errori con ripetizione e notifica
- Protocollazione di ogni scambio per la tracciabilità
- Monitoraggio che segnala quando la connessione si ferma
- Documentazione per il caso in cui qualcun altro debba manutenerla in seguito
04 — Domande
Domande frequenti
Un'interfaccia è più sicura di un'esportazione manuale?
Decisamente, perché vengono eliminati gli errori umani nell'esportazione e importazione e ogni scambio viene protocollato. Un'esportazione manuale non lascia traccia se qualcosa viene trascurato.
Quanto costa la manutenzione durante l'esercizio?
Finché nessuno dei sistemi collegati cambia radicalmente, il lavoro corrente è ridotto — il monitoraggio si segnala da solo quando qualcosa non va.
Chi la manutiene in seguito?
Ricevi codice e documentazione. Costruiamo deliberatamente con tecnologie diffuse, affinché un cambio sia possibile.
Cosa succede in caso di interruzione?
La connessione memorizza ciò che non è ancora stato trasmesso, riprova e segnala dopo diversi tentativi falliti. I dati non vengono persi, arrivano in ritardo.
E se il nostro sistema legacy non ha un'interfaccia?
Allora ci sono di solito soluzioni alternative: accesso al database, scambio automatizzato di file, in casi eccezionali automazione dell'interfaccia utente. Tutte sono più fragili di un'interfaccia vera. Ti diciamo onestamente quanto sarà stabile una soluzione del genere, prima che tu decida.
È possibile collegare più sistemi contemporaneamente?
Sì, è addirittura il caso più frequente — ad esempio shop, gestione merci e contabilità insieme. Ogni connessione viene pianificata e testata singolarmente, anche se alla fine tutto funziona insieme.
Con quale frequenza vengono sincronizzati i dati?
Da immediato a notturno — a seconda di ciò che è tecnicamente necessario. La sincronizzazione immediata non è sempre migliore: nei sistemi con post-elaborazione un'esecuzione notturna è spesso la scelta più stabile.
05 — Decisione
Come andare avanti
Il prossimo passo più conveniente è una conversazione, non un'offerta. Venti minuti bastano di solito per chiarire se un progetto ha senso, in quale ambito si colloca e se siamo le persone giuste.
Se non lo siamo, lo diciamo. Un no onesto costa meno di un progetto che si interrompe dopo tre mesi — per entrambe le parti.
06 — Avanti
Pagine correlate
- Interfacce API — Panoramica
- Interfacce API — Durata
- Interfacce API — Checklist
- Interfacce API — Fare da soli
- Interfacce API — Da dove iniziare
- Interfacce API — Confronto fornitori
- Interfacce API — Contratto e proprietà
- Interfacce API — Requisiti
- Automazione dei processi
- Software personalizzato
- Integrazione CRM
- Tutte le guide
Prossimo passo
Analizziamo la tua situazione di partenza.
Raccontaci cosa ti fa perdere tempo oggi. Da lì nasce una valutazione con costi e benefici — e solo dopo un preventivo.