Mengapa JSON Buatan Tangan Berantakan

Pada awalnya Anda membuat JSON secara manual, menyalin setiap bidang dari model ke dalam sebuah dict. Cara ini terasa sederhana, dan untuk satu titik akhir memang demikian.

Tambahkan beberapa kolom, dan dict Anda bertambah baris demi baris. Tak lama kemudian, satu model berarti blok panjang pasangan kunci-nilai yang rapuh dan harus tetap sinkron.

Titik akhir daftar dan detail sama-sama membuat ulang dict yang sama. Duplikasi itu berarti satu penggantian nama memaksa Anda mengedit bentuk yang sama di banyak tempat.

Datetime mentah tidak ramah terhadap JSON, sehingga jsonify gagal atau menebak-nebak. Kode manual jarang memformat tanggal dengan cara yang sama dua kali di seluruh aplikasi Anda.

Buang seluruh model, dan Anda mungkin ikut mengirim password_hash atau flag internalnya. JSON yang dirakit sendiri terlalu mudah mengekspos bidang pribadi.

Satu pengguna dengan banyak kiriman berarti perulangan di dalam dict, di dalam daftar. Struktur Nested mengubah kode serialisasi Anda menjadi kusut dan tidak enak dibaca.

JSON yang dirakit sendiri hanya memikirkan keluaran. Payload yang masuk tetap datang tanpa pemeriksaan, sehingga validasi menjadi tumpukan pernyataan if lain yang harus Anda tulis manual.

Sebuah skema mendeskripsikan data Anda sekali: bidang apa yang ada, tipenya, dan aturannya. Keluaran maupun masukan kemudian diproses melalui deskripsi tunggal itu.

Marshmallow adalah pustaka populer untuk hal ini di Flask. Anda mendeklarasikan kelas Schema, lalu pustaka itu menangani serialisasi keluaran dan validasi masukan.

Dengan skema, daftar bidang berada di satu tempat. Ganti nama atau hapus bidang di sana, dan setiap titik akhir otomatis tetap konsisten.

Anda mengganti lusinan baris dict yang rapuh dengan kelas yang rapi. Hasilnya adalah kode yang lebih sedikit, keluaran yang lebih aman, dan kontrak yang jelas untuk API Anda.

JSON yang dirakit sendiri menggandakan pekerjaan, menangani tanggal dengan buruk, dan membocorkan rahasia. Lapisan skema seperti Marshmallow memusatkan bentuk data Anda untuk keluaran yang rapi dan aman.