Saya akan menyarankan kembali hanya apa yang diperlukan + sedikit klarifikasi.
Misalnya, tergantung pada bagaimana API Anda digunakan, Anda bisa menyertakan salinan objek, seperti yang ada setelah disimpan.
Jadi POST dari {key: 123} mungkin mengembalikan {key: 123, foo: 'bar'}.
Ide dasarnya adalah lebih baik mengembalikan objek daripada harus meminta lagi.
Yang mengatakan, konsumen API Anda tidak perlu objek tidak perlu mengembalikannya.
Saya biasanya mengembalikan {success: true} atau semacamnya, ketika tidak ada objek yang diperlukan pada POST PUT dan PATCH karena itu membuatnya lebih mudah untuk penerima. Yang mengatakan, lebih baik 99% dari waktu untuk mengembalikan representasi objek yang disimpan, jarang bahwa mereka tidak akan memerlukannya, dan itu "lebih murah" untuk mengirim semuanya dalam satu permintaan kemudian dalam dua.
Untuk lebih spesifik, di laboratorium itu sangat mudah untuk menangani semuanya hanya dengan kode status, di dunia nyata, jauh lebih baik untuk mengembalikan beberapa data, bahkan jika berlebihan, sehingga konsumen API dapat dengan mudah memahami apa yang ingin Anda katakan.
Mengembalikan 200 {success: true} memungkinkan orang menulis kode dengan dua cara:
if response.code == 200
do stuff
end
dan
if response.body.success
do stuff
end
selain itu tidak sulit untuk dilakukan di sisi Anda.
Terakhir, (maaf untuk struktur jawaban poos), dengan memberikan api JSON publik Anda menyerahkan banyak kontrol tentang bagaimana itu akan digunakan. Beberapa klien mungkin bereaksi berbeda terhadap badan yang berbeda (atau tidak ada) atau kode status.