Jika dokumentasi menggambarkan bidang ini sebagai salah satu dari Anjing, Kucing, atau Ikan, maka ya, menambahkan jenis lain akan mengubah antarmuka dengan cara yang tidak kompatibel ke belakang. Dapat dibayangkan sepenuhnya bahwa konsumen API Anda telah menulis kode khusus untuk menangani anjing dan kucing secara berbeda dari pada ikan. Dengan tipe yang tidak dikenal, konsumen itu tidak akan tahu apa yang harus dilakukan dengan respons Anda. Tapi ini sangat tergantung pada apa yang diwakili oleh jenis placeholder ini "Kucing" dan "Ikan" dalam domain masalah Anda yang sebenarnya ...
Jika perubahan pada daftar tipe yang mungkin sering terjadi, atau jika daftar tidak terbatas, maka mendokumentasikan hal ini adalah masuk akal. Bergantung pada kasus penggunaan Anda, mungkin baik untuk mengekspos daftar semua jenis yang mungkin sebagai titik akhir di API Anda - dengan cara itu jelas Anda dapat menambah atau menghapus jenis tanpa harus memperbarui versi API. Namun, semakin dinamis jenis Anda, semakin sulit bagi konsumen API untuk melakukan sesuatu yang spesifik jenis. Apakah ekstensibilitas atau kemudahan penggunaan lebih penting tergantung pada kasus penggunaan dan domain masalah Anda.