Funzionalità
OpenAPI
Un’API documentata nello standard OpenAPI, perché il sistema non diventi un’isola.
OpenAPI
Un sistema senza API è un sistema destinato a diventare un’isola alla prima esigenza nuova. Poiché il codice è della tua azienda, il fatto che quell’API esista e sia documentata è ciò che garantisce che qualsiasi fornitore possa lavorarci in futuro.
Cosa entra di solito
-
Contratto in OpenAPI
Una specifica nello standard OpenAPI, generata insieme al codice — documentazione che non può scollarsi dall’implementazione.
-
Autenticazione e ambiti
Credenziale di servizio con permessi minimi per integrazione. Ogni consumatore riceve solo ciò che gli serve.
-
Versionamento
Una modifica che rompe il contratto entra in una versione nuova, con la precedente mantenuta per il periodo concordato.
-
Webhook
Invece che l’altra parte continui a chiedere, il sistema avvisa quando l’evento accade, con reinvio in caso di errore.
Come lo costruisce Nivrix
-
Prima il contratto, poi il codice
La specifica si concorda per prima, così chi dovrà consumarla può iniziare in parallelo.
-
Limiti e registro
Ogni consumatore ha un limite di chiamate e un registro d’uso — perché un integratore non possa far cadere l’operatività.
-
Ambiente di prova
Chi integra prova contro un ambiente separato, con dati di test, prima di toccare la produzione.
Si integra bene con
Domande su questo modulo
Anche l’API è mia?
Sì. A fine progetto il codice è della tua azienda, API e specifica comprese. Un altro fornitore può proseguire partendo dalla documentazione.
Un altro sistema può scrivere dati?
Può, con le stesse regole di validazione e permesso dell’interfaccia. Nessun percorso di scrittura si fida di ciò che arriva senza verificarlo sul server.
Capiamo insieme la tua operatività.
Fai la diagnosi o guarda come lavoriamo. Senza impegno.