-
Versionamento API di Stripe: come funziona e cosa copiare
Il versionamento API di Stripe fissa ogni account a una versione datata e ammette l'override per richiesta. Come funziona, cosa costa e cosa copiare.
Modifiche alle API7 min di lettura
-
I breaking change di Protobuf: cosa sopravvive sul wire
I breaking change di Protobuf avvengono sul wire, non nell'URL. Certi cambi di campo gRPC sono gratis, altri rompono i client muti, e sembrano uguali.
Modifiche alle API6 min di lettura
-
Deprecazione di GraphQL senza numero di versione
GraphQL non ha v1 o v2 nell'URL. I campi si deprecano uno alla volta con una direttiva, su uno schema condiviso, e questo cambia cosa deve un changelog.
Modifiche alle API6 min di lettura
-
Come scrivere una guida di migrazione per API
Una guida di migrazione API trasforma un cambiamento incompatibile in una checklist. Cosa deve contenere, e perché una voce di changelog da sola non basta.
Modifiche alle API5 min di lettura
-
Changelog di API interne: cosa cambia per l'altro team
Un changelog di API pubblica ha un pubblico che non puoi contattare. Uno interno ha un pubblico a due piani di distanza, e questo cambia cosa gli si deve.
Modifiche alle API6 min di lettura
-
L'header sunset delle API, e quando inviarne uno
L'header sunset delle API dice quando una versione smette di rispondere, a differenza di una deprecazione. Cosa copre la RFC 8594, cosa dà un brownout.
Modifiche alle API5 min di lettura
-
Changelog dei webhook: il breaking change non richiesto
Un cambiamento nel payload di un webhook si rompe in silenzio, perché nessuno lo rifiuta. Cosa rende breaking un cambio di payload, e come versionarlo.
Modifiche alle API6 min di lettura
-
Changelog di API: cosa pubblicare e chi lo legge
Un changelog di API lo legge chi decide se il proprio codice funzionerà ancora il mese prossimo. Cosa deve ogni voce, dove vive, come ci si iscrive.
Modifiche alle API7 min di lettura
-
Come deprecare un'API senza perdere gli sviluppatori
La deprecazione è una promessa con una data. Il calendario, il modello di avviso, gli header di risposta, e il passo che evita un incidente al sunset.
Modifiche alle API7 min di lettura
-
Buone pratiche di versionamento API, per i chiamanti
Versionate solo ciò che rompe qualcosa, mettete la versione ben visibile, e mantenete la vecchia attiva fino a una data. Quattro schemi a confronto.
Modifiche alle API8 min di lettura
-
Cambiamenti che rompono: cosa conta e come rilasciarli
Un cambiamento che rompe qualcosa è uno che un chiamante corretto non sopravvive. Cosa conta, cosa no, come intercettarlo in CI e come rilasciarlo.
Modifiche alle API10 min di lettura
