Tetapkan Kode Status pada Balasan JSON

Setiap respons HTTP membawa kode status yang menandakan keberhasilan atau kegagalan. Isi JSON menjelaskan detailnya, tetapi kode status terlebih dahulu menentukan makna umumnya. 🚦

Saat Anda hanya mengembalikan jsonify, Flask mengirimkan 200 OK. Ini sempurna untuk pembacaan yang berhasil, tetapi tindakan lain memerlukan kodenya sendiri.

Untuk memilih kode, kembalikan tuple yang berisi respons JSON dan angkanya. Flask membaca elemen kedua sebagai status HTTP yang harus dikirim.

Saat permintaan membuat catatan baru, balas dengan 201 Created. Ini memberi tahu klien bahwa sumber daya tersebut kini ada, sesuatu yang tidak dapat disampaikan oleh 200 saja.

Jika item yang diminta tidak ada, kembalikan isi JSON dengan 404. Klien mengetahui bahwa sumber daya tersebut tidak ada, bukan bahwa server mengalami kerusakan.

Saat klien mengirim data yang tidak valid, balas dengan 400 Bad Request. Sertakan pesan JSON yang menjelaskan dengan tepat apa yang salah.

Kode dalam rentang 2xx berarti berhasil. 200 berarti membaca, 201 berarti membuat, dan 204 menandakan keberhasilan tanpa isi yang dikirim kembali.

Kode dalam rentang 4xx menunjukkan kesalahan pada klien. 400 berarti input salah, 401 berarti belum terautentikasi, dan 403 berarti dilarang.

Kode dalam rentang 5xx menunjukkan kesalahan pada server. 500 berarti kode Anda memunculkan kesalahan yang tidak tertangani saat memproses permintaan yang sebenarnya valid.

Anda dapat memperluas tuple menjadi tiga bagian: isi, status, dan dict headers. Dengan begitu, Anda dapat melampirkan metadata tambahan dalam satu pengembalian yang rapi.

Pilih kode yang tepat untuk setiap hasil dan gunakan secara konsisten. Kode status yang konsisten membuat API Anda dapat diprediksi dan mudah diintegrasikan.

Anda telah mempelajari cara memasangkan isi JSON dengan kode status yang tepat melalui pengembalian tuple, serta menggunakan 201, 404, dan 400 agar API Anda jelas dan jujur. ✅