Contratto API

Una specifica formale di un'API (OpenAPI, proto gRPC, schema GraphQL) che produttori e consumatori si impegnano a rispettare.

Che cos'è Contratto API?

Un contratto API trasforma un'interfaccia da conoscenza tribale a un artefatto versionato. Abilita codice generato per i client, controlli di compatibilità in CI e test di contratto guidati dai consumatori. Per il coordinamento tra team è uno dei pezzi di documentazione a più alto impatto che un'architettura possa possedere.

Termini correlati

  • Canale di Eventi — Uno stream di eventi denominato e tipizzato (spesso un topic Kafka o equivalente) attraverso cui i servizi pubblicano e si sottoscrivono in modo asincrono.
  • Microservizi — Uno stile architetturale che struttura un'applicazione come un insieme di servizi piccoli, distribuibili in modo indipendente e organizzati intorno alle capacità di business.

Scopri di più