Panduan

Versi dan perubahan API

Kebijakan versi dan riwayat perubahan publik harus disetujui penanggung jawab backend. Selama belum tersedia, jangan menganggap perubahan apa pun tetap kompatibel di luar ketentuan tertulis.

Jenis perubahan

  • Tambahan: kolom atau endpoint baru yang tidak mengubah arti kolom yang sudah ada.
  • Perilaku: perubahan perhitungan, urutan bawaan, sumber, kesegaran data, atau aturan nilai kosong.
  • Breaking change: perubahan nama, penghapusan, perubahan tipe, izin, atau format tanggal yang dapat merusak integrasi.

Tanggung jawab pengguna API

Integrasi perlu menerima kolom tambahan tanpa gagal, tetapi tetap harus memeriksa tipe data dan kolom wajib yang digunakan oleh proses bisnis.

Riwayat perubahan, masa penghentian dukungan, dan penanda versi belum menjadi SLA sampai mendapat persetujuan resmi.