Perubahan API
Perubahan yang merusak kompatibilitas, deprekasi, dan versioning, disampaikan kepada orang yang terdampak.
-
Versioning API Stripe: cara kerjanya dan apa yang ditiru
Versioning API Stripe mengunci tiap akun ke versi bertanggal dan membolehkan setiap request menimpanya. Cara kerja, biaya, dan yang bisa ditiru API kecil.
Perubahan API6 menit baca
-
Protobuf breaking changes: apa yang bertahan di wire
Protobuf breaking changes terjadi di wire, bukan di URL. Sebagian perubahan field gRPC gratis, sebagian merusak setiap client diam-diam, dan tampak sama.
Perubahan API5 menit baca
-
Deprecation GraphQL tanpa nomor versi
GraphQL tidak punya v1 atau v2 di URL. Field di-deprecate satu per satu dengan directive, pada satu skema bersama, yang mengubah kewajiban changelog.
Perubahan API5 menit baca
-
Cara menulis panduan migrasi API
Panduan migrasi API mengubah perubahan tak kompatibel menjadi checklist, bukan gangguan. Apa yang dibutuhkan, dan mengapa entri changelog saja tak cukup.
Perubahan API4 menit baca
-
Changelog API internal: apa yang berubah bagi tim lain
Changelog API publik punya audiens yang tidak bisa dihubungi langsung. Yang internal punya audiens dua lantai jauhnya, dan itu mengubah isinya.
Perubahan API5 menit baca
-
Changelog webhook: breaking change yang tak diminta
Perubahan payload webhook rusak diam-diam, karena tak ada pemanggil yang bisa menolaknya. Apa yang membuat payload breaking, serta cara memberi versi.
Perubahan API5 menit baca
-
Header sunset API, dan kapan mengirimkannya
Header sunset API memberi tahu klien kapan versi berhenti merespons, beda dari notifikasi deprecation. Cakupan RFC 8594, dan manfaat brownout sebelumnya.
Perubahan API5 menit baca
-
Changelog API: apa yang dipublikasikan, siapa pembacanya
Changelog API dibaca orang yang memutuskan apakah kodenya masih berfungsi bulan depan. Apa yang harus diberikan tiap entri, letaknya, dan cara langganan.
Perubahan API6 menit baca
-
Cara men-deprecate API tanpa kehilangan developer
Deprecation adalah janji dengan tanggal. Jadwalnya, template pemberitahuan, header respons, dan langkah yang mencegah sunset menjadi insiden.
Perubahan API6 menit baca
-
Praktik terbaik versi API, demi kepentingan pemanggil
Versikan hanya yang merusak, taruh versinya di tempat yang terlihat pemanggil, dan jaga versi lama berjalan sampai tanggal tertentu. Empat skema.
Perubahan API6 menit baca
-
Breaking change: apa yang terhitung dan cara merilisnya
Breaking change adalah perubahan yang tidak bisa dilalui pemanggil yang benar. Apa yang terhitung, apa yang tidak, cara menangkapnya di CI, dan merilisnya.
Perubahan API8 menit baca
