Perubahan additive adalah default yang sehat
Menambahkan field baru biasanya lebih aman daripada mengganti nama atau mengubah tipe field yang sudah dipakai klien. Namun additive change tetap perlu dokumentasi agar consumer tidak menganggap response selalu memiliki bentuk lama.
Untuk perubahan yang tidak kompatibel, pilih strategi versioning yang dapat dipahami tim: path, header, atau media type. Yang penting adalah ada masa deprecation dan telemetry pemakaian versi lama.
Kontrak perlu diuji oleh consumer
Contract test menangkap perubahan yang terlihat kecil tetapi memutus client. Test tersebut sebaiknya berjalan terhadap schema yang sama dengan yang digunakan gateway dan service downstream.
