Perkara Penting untuk Mereka Bentuk Kontrak Data JSON API
Enam perkara sangat sukar diubah selepas dihantar: sampul respons, format kesalahan, bentuk penomboran halaman, perwakilan ID dan masa, semantik null berbanding ketiadaan, dan evolusi versi.
Meletakkan JSON ke dalam sistem sebenar: cara mentakrifkan kontrak API, cara mengurus konfigurasi dan fixture, cara mengendalikan keserasian versi, dan cara menyelenggara data ujian.
5 artikelEnam perkara sangat sukar diubah selepas dihantar: sampul respons, format kesalahan, bentuk penomboran halaman, perwakilan ID dan masa, semantik null berbanding ketiadaan, dan evolusi versi.
Konfigurasi mesti berlapis dan disahkan; fixture mesti deterministik, boleh dibaca, dan boleh dibezakan. Jika dua jenis fail ini diurus dengan buruk, kos penyelesaian masalah kekal tinggi untuk masa yang lama.
Lima puluh rekod menjadi lima puluh satu dan diff melaporkan lima puluh satu perubahan. Merangkumi positif palsu diff teks, memadankan tatasusunan mengikut id, normalisasi jq dan patch yang boleh digunakan.
merge=union membiarkan JSON rosak lalu dan masih melaporkan kejayaan. Ini menelusuri pemacu cantum tiga hala peka kunci untuk JSON, serta tiga tabiat yang mengurangkan konflik.
Menambah medan tidak secara automatik selamat. Merangkumi sempadan keserasian, medan versi, tetingkap penandaan usang, migrasi tulis berganda, ujian kontrak dan metrik kenari.