Cara yang tenang untuk menghapus banyak item

Dalam artikel wiki untuk REST ditunjukkan bahwa jika Anda menggunakan http://example.com/resources DELETE, itu berarti Anda menghapus seluruh koleksi.

Jika Anda menggunakan http://example.com/resources/7HOU57Y DELETE, artinya Anda menghapus elemen tersebut.

Saya membuat SITUS WEB, catat BUKAN LAYANAN WEB.

Saya memiliki daftar yang memiliki 1 kotak centang untuk setiap item di daftar. Setelah saya memilih beberapa item untuk dihapus, saya akan mengizinkan pengguna untuk menekan tombol bernama DELETE SELECTION. Jika pengguna menekan tombol, kotak dialog js akan muncul meminta pengguna untuk mengkonfirmasi penghapusan. jika pengguna mengkonfirmasi, semua item akan dihapus.

Jadi, bagaimana saya harus melayani penghapusan beberapa item dengan cara yang RESTFUL?

CATATAN, saat ini untuk DELETE di halaman web, yang saya lakukan adalah menggunakan tag FORM dengan POST sebagai tindakan tetapi menyertakan _method dengan nilai DELETE karena ini adalah apa yang ditunjukkan oleh orang lain di SO tentang cara melakukan penghapusan RESTful untuk halaman web .

Saya pikir jawaban rojoca sejauh ini adalah yang terbaik. Sedikit variasi mungkin, untuk menghilangkan konfirmasi javascript pada halaman yang sama, dan sebaliknya, membuat pilihan dan mengarahkan ulang ke sana, menunjukkan pesan konfirmasi pada halaman itu. Dengan kata lain:

Dari:
http://example.com/resources/

lakukan a

POSTING dengan ID pilihan untuk:
http://example.com/resources/selections

yang, jika berhasil, harus merespons dengan:

HTTP / 1.1 201 dibuat, dan tajuk Lokasi ke:
http://example.com/resources/selections/DF4XY7

Pada halaman ini Anda akan melihat kotak konfirmasi (javascript), yang jika Anda konfirmasi akan melakukan permintaan:

HAPUS http://example.com/resources/selections/DF4XY7

yang, jika berhasil, harus merespons dengan: HTTP / 1.1 200 Ok (atau apa pun yang sesuai untuk penghapusan yang berhasil)

Salah satu opsinya adalah membuat "transaksi" hapus. Jadi Anda POSTseperti http://example.com/resources/deletessumber daya baru yang terdiri dari daftar sumber daya yang akan dihapus. Kemudian di aplikasi Anda, Anda tinggal melakukan delete. Ketika Anda melakukan posting, Anda harus mengembalikan lokasi transaksi yang Anda buat, misalnya http://example.com/resources/deletes/DF4XY7. A GETini dapat mengembalikan status transaksi (selesai atau dalam proses) dan / atau daftar sumber daya yang akan dihapus.

Inilah yang dilakukan Amazon dengan S3 REST API mereka.

Permintaan penghapusan individu:

DELETE /ObjectName HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Content-Length: length
Authorization: authorization string (see Authenticating Requests (AWS Signature Version 4))

Permintaan Hapus Multi-Objek :

POST /?delete HTTP/1.1
Host: bucketname.s3.amazonaws.com
Authorization: authorization string
Content-Length: Size
Content-MD5: MD5

<?xml version="1.0" encoding="UTF-8"?>
<Delete>
    <Quiet>true</Quiet>
    <Object>
         <Key>Key</Key>
         <VersionId>VersionId</VersionId>
    </Object>
    <Object>
         <Key>Key</Key>
    </Object>
    ...
</Delete>           

Tetapi Facebook Graph API , Parse Server REST API, dan Google Drive REST API melangkah lebih jauh dengan memungkinkan Anda untuk "menumpuk" operasi individual dalam satu permintaan.

Berikut contoh dari Parse Server.

Permintaan penghapusan individu:

curl -X DELETE \
  -H "X-Parse-Application-Id: ${APPLICATION_ID}" \
  -H "X-Parse-REST-API-Key: ${REST_API_KEY}" \
  https://api.parse.com/1/classes/GameScore/Ed1nuqPvcm

Permintaan batch:

curl -X POST \
  -H "X-Parse-Application-Id: ${APPLICATION_ID}" \
  -H "X-Parse-REST-API-Key: ${REST_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
        "requests": [
          {
            "method": "POST",
            "path": "/1/classes/GameScore",
            "body": {
              "score": 1337,
              "playerName": "Sean Plott"
            }
          },
          {
            "method": "POST",
            "path": "/1/classes/GameScore",
            "body": {
              "score": 1338,
              "playerName": "ZeroCool"
            }
          }
        ]
      }' \
  https://api.parse.com/1/batch

Saya akan mengatakan HAPUS http://example.com/resources/id1,id2,id3,id4 atau HAPUS http://example.com/resources/id1+id2+id3+id4 . Karena "REST adalah arsitektur (...) [bukan] protokol" untuk mengutip artikel wikipedia ini, saya yakin, tidak ada satu cara pun untuk melakukan ini.

Saya sadar bahwa di atas tidak mungkin tanpa JS dengan HTML tetapi saya merasa REST adalah:

• Dibuat tanpa memikirkan detail kecil seperti transaksi. Siapa yang perlu mengoperasikan lebih dari satu item? Ini entah bagaimana dibenarkan dalam protokol HTTP karena tidak dimaksudkan untuk melayani melalui itu apa pun selain halaman web statis.
• Tidak perlu menyesuaikan dengan baik ke model saat ini - bahkan HTML murni.

Menariknya, saya pikir metode yang sama berlaku untuk PATCHing beberapa entitas, dan memerlukan pemikiran tentang apa yang kami maksud dengan URL, parameter, dan metode REST kami.

1. kembalikan semua elemen 'foo':

   [GET] api/foo

2. kembalikan elemen 'foo' dengan pemfilteran untuk id tertentu:

   [GET] api/foo?ids=3,5,9

Dimana artinya adalah URL dan filter menentukan "elemen apa yang kita hadapi?", Dan metode REST (dalam hal ini "GET") mengatakan "apa yang harus dilakukan dengan elemen tersebut?"

1. Oleh karena itu PATCH beberapa record untuk menandainya sebagai telah dibaca

   [PATCH] api/foo?ids=3,5,9

..dengan data foo [read] = 1

1. Terakhir untuk menghapus beberapa rekaman, titik akhir ini paling logis:

   [DELETE] api/foo?ids=3,5,9

Tolong mengerti, saya tidak percaya ada "aturan" tentang ini - bagi saya itu "masuk akal"

Seperti yang dikatakan jawaban Decent Dabbler dan jawaban rojocas , yang paling kanonik adalah menggunakan sumber daya virtual untuk menghapus pilihan sumber daya, tetapi menurut saya itu salah dari perspektif REST, karena menjalankan a DELETE http://example.com/resources/selections/DF4XY7harus menghapus sumber daya pilihan itu sendiri, bukan sumber daya yang dipilih.

Mengambil anwser Maciej Piechotka atau jawaban fezfox , saya hanya memiliki keberatan: Ada cara yang lebih kanonik untuk melewatkan array id, dan menggunakan operator array:

DELETE /api/resources?ids[]=1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d&ids[]=7e8f9a0b-1c2d-3e4f-5a6b-7c8d9e0f1a2b

Dengan cara ini Anda menyerang ke titik akhir Koleksi Hapus tetapi memfilter penghapusan dengan string kueri dengan cara yang benar.

Karena tidak ada cara yang 'tepat' untuk melakukan ini, apa yang telah saya lakukan di masa lalu adalah:

kirim HAPUS ke http://example.com/something dengan data yang dikodekan xml atau json di bagian isi.

ketika Anda menerima permintaan, periksa HAPUS, jika benar, kemudian baca isi untuk yang akan dihapus.

Saya memiliki situasi yang sama untuk menghapus beberapa item. Inilah yang akhirnya saya lakukan. Saya menggunakan operasi DELETE dan id item yang akan dihapus adalah bagian dari header HTTP.