Desain istirahat - Beberapa panggilan vs. mengembalikan semua data dalam satu panggilan

Saya mencoba membuat API sisanya untuk aplikasi android. Misalkan saya punya userstabel dengan (id, name, email)dan songsmeja dengan (id, song_name, album)dan kaya bergabung hubungan antara mereka sebagai streamsmemiliki (user_id, song_id, listen_count). Saya ingin mengambil detail tentang semua aliran dan menunjukkannya di aplikasi sebagai daftar. Daftar akan menampilkan nama lagu, nama album, nama pengguna dan jumlah mendengarkan. Saya melihat tiga opsi yang masuk akal -

1. GETke /streamsdan mengambil daftar semua song_idsdan user_ids. Kemudian buat GETke /user/:iddan /song/:iduntuk setiap pengguna dan id lagu untuk mendapatkan informasi pengguna dan lagu.
2. GETke /streamsdan mengambil daftar semua user_idsdan song_ids. Kemudian salah satu GETuntuk /user?ids=<comma_separated_ids>mengambil informasi tentang semua pengguna dan GETuntuk song?ids=<comma_separated_ids>mengambil informasi tentang semua lagu.

3. GETuntuk /streamsdan mengambil semuanya dalam satu panggilan. Sesuatu seperti -

   [
   
     {
   
       "user_id" : 10,
       "song_id" : 14,
       "listen_count" : 5,
       "user" : {
         "id"     : 10,
         "name"   : "bla", 
         "email"  : "bla",
       },
       "song" : {
         "id"     : 14,
         "name"   : "blu",
         "album"  : "blu"
      }
     },
   ...
   ]
   

Saya tergoda untuk menggunakan opsi 3 karena memberi saya segalanya dalam satu panggilan, tetapi saya tidak berpikir itu sangat tenang dan saya khawatir itu tidak akan terukur. Opsi 2 baik tetapi dibutuhkan 3 panggilan yang berarti cukup banyak waktu memuat daftar. Dan opsi 1 mengikuti istirahat tetapi akan menerima banyak panggilan untuk menunjukkan daftar dan melakukan begitu banyak panggilan dari perangkat seluler tidak layak.

Apa yang akan menjadi cara yang disarankan untuk melakukan ini?

Saat membuat antarmuka REST, tidak ada persyaratan, atau bahkan harapan, bahwa respons pada antarmuka REST berhubungan langsung dengan tabel atau bergabung dalam database.

/streamsAntarmuka Anda dapat dengan mudah direpresentasikan sebagai

[
  {
    "listen_count" : 5,
    "user" : {
      "href"     : "/users/10",
      "name"   : "bla", 
    },
    "song" : {
      "href"     : "/songs/14",
      "name"   : "blu",
      "album"  : "blu"
    }
  },
  ...
]

Di mana objek JSON berisi detail utama pengguna dan lagu yang (hampir) selalu relevan bagi konsumen sumber daya streaming, dan tautan ke sumber daya pengguna / lagu yang relevan jika diperlukan rincian lebih lanjut.

Ini pada dasarnya adalah variasi dari opsi ketiga Anda, dengan mundur ke opsi 1 jika diperlukan lebih banyak detail.

Anda pasti menginginkan satu GEToperasi yang mengembalikan metadata tentang setiap lagu dan pengguna selain id buram mereka.

• Seperti yang Anda tunjukkan, ini jauh lebih sederhana. Itu hal yang baik.
• Membuat salah satu operasi paling umum untuk aplikasi klien Anda sebagai permintaan server tunggal alih-alih permintaan O (n) jauh lebih skalabel. Dalam jangka panjang, jaringan akan menjadi hambatan terbesar Anda, jadi Anda tidak ingin mengirim permintaan lebih dari yang seharusnya.
• Id sendiri agak tidak berguna kecuali untuk membuat panggilan REST tambahan.
• Selama metadata Anda memiliki ukuran yang relatif kecil dan terbatas (mis. Tidak ada halaman teks deskriptif atau file audio aktual, hanya nama, tipe, jumlah, dan sebagainya) mengembalikannya sebagai tambahan id tidak akan menjadi masalah kinerja.