Спокійний спосіб видалення купу предметів

У статті wiki для REST зазначено, що якщо ви використовуєте http://example.com/resources DELETE, це означає, що ви видаляєте всю колекцію.

Якщо ви використовуєте http://example.com/resources/7HOU57Y DELETE, це означає, що ви видаляєте цей елемент.

Я роблю ВЕБ-САЙТ, зверніть увагу НЕ ВЕБ-СЕРВІС.

У мене є список, який має 1 прапорець для кожного елемента у списку. Після того, як я вибрав кілька елементів для видалення, я дозволю користувачам натиснути кнопку, яка називається ВИДАЛИТИ ВИБОР. Якщо користувач натискає кнопку, відкриється діалогове вікно js з проханням підтвердити видалення. якщо користувач підтвердить, всі елементи видаляються.

Отже, як мені забезпечити видалення декількох елементів ВІДСТАВЛЕНО?

ПРИМІТКА. В даний час для ВИДАЛЕННЯ на веб-сторінці я використовую тег FORM з POST як дію, але включаю _метод зі значенням DELETE, оскільки саме це було зазначено іншими в SO про те, як зробити RESTful видалення для веб-сторінки .

Я думаю , що відповідь rojoca є найкращою на сьогодні. Можливі незначні варіації - скасувати підтвердження javascript на тій самій сторінці, а замість цього створити виділення та перенаправити на нього, показавши на цій сторінці повідомлення про підтвердження. Іншими словами:

З:
http://example.com/resources/

робити a

POST із вибором ідентифікаторів:
http://example.com/resources/selections

який у разі успіху повинен відповісти:

Створено HTTP / 1.1 201 та заголовок Location до:
http://example.com/resources/selections/DF4XY7

На цій сторінці ви побачите поле підтвердження (javascript), яке, якщо підтвердите, виконає запит:

ВИДАЛИТИ http://example.com/resources/selections/DF4XY7

який у разі успіху повинен відповісти: HTTP / 1.1 200 Ok (або що підходить для успішного видалення)

Одним із варіантів є створення "транзакції" видалення. Отже, ви POSTперейшли на щось на зразок http://example.com/resources/deletesнового ресурсу, що складається зі списку ресурсів, які потрібно видалити. Тоді у вашій програмі ви просто виконуєте видалення. Коли ви робите пост , ви повинні повернути прихильність вашої створеної транзакції , наприклад, http://example.com/resources/deletes/DF4XY7. A GETщодо цього може повернути статус транзакції (завершеної або триває) та / або список ресурсів, які потрібно видалити.

Ось що Amazon зробила зі своїм API SEST REST.

Індивідуальний запит на видалення:

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))

Запит на видалення декількох об’єктів :

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>           

Але Facebook Graph API , Аналізувати сервер REST API і Google Drive API REST піти ще далі, дозволяючи «пакетні» окремі операції в одному запиті.

Ось приклад із сервера розбору.

Індивідуальний запит на видалення:

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

Пакетний запит:

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

Я б сказав DELETE http://example.com/resources/id1,id2,id3,id4 або DELETE http://example.com/resources/id1+id2+id3+id4 . Оскільки "REST - це архітектурний (...) [не] протокол", щоб цитувати цю статтю Вікіпедії, я вважаю, що немає єдиного способу зробити це.

Я усвідомлюю, що вище неможливо без JS з HTML, але я відчуваю, що REST:

• Створено, не замислюючись про незначні деталі, такі як транзакції. Кому потрібно буде оперувати більше, ніж один предмет? Це якось виправдано в протоколі HTTP, оскільки він не мав на меті подавати через нього будь-що інше, ніж статичні веб-сторінки.
• Не потрібно добре пристосовуватися до сучасних моделей - навіть чистого HTML.

Цікаво, що я думаю, що той самий метод застосовується як для PATCHing декількох об'єктів, і вимагає думати про те, що ми маємо на увазі під нашою URL-адресою, параметрами та методом REST.

1. повертає всі елементи 'foo':

   [GET] api/foo

2. повертає елементи 'foo' з фільтруванням для конкретних ідентифікаторів:

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

У цьому сенсі URL і фільтр визначають "з якими елементами ми маємо справу?", А метод REST (у даному випадку "GET") говорить "що робити з цими елементами?"

1. Звідси PATCH кілька записів, щоб позначити їх як прочитані

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

..з даними foo [читання] = 1

1. Нарешті, щоб видалити кілька записів, ця кінцева точка є найбільш логічною:

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

Зрозумійте, я не вірю, що в цьому є якісь "правила" - для мене це просто "має сенс"

Як відповідає відповідь Decent Dabbler та відповідь rojocas , найбільш канонічним є використання віртуальних ресурсів для видалення виділених ресурсів, але я вважаю, що це неправильно з точки зору REST, оскільки при виконанні a DELETE http://example.com/resources/selections/DF4XY7слід видалити сам ресурс виділення, а не вибрані ресурси.

Беручи відповідь Maciej Piechotka або відповідь fezfox , я маю лише заперечення: існує більш канонічний спосіб передачі масиву ідентифікаторів, і використовується оператор масиву:

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

Таким чином ви атакуєте кінцеву точку Видалити колекцію, але правильно фільтруєте видалення за допомогою рядка запитів.

Оскільки немає "належного" способу зробити це, то, що я робив у минулому, є:

надішліть DELETE на http://example.com/something із кодованими даними xml або json у тілі.

одержавши запит, перевірте на ВИДАЛЕННЯ, якщо істинно, а потім прочитайте текст для тих, які потрібно видалити.

У мене була однакова ситуація з видаленням кількох елементів. Це те, що я закінчив робити. Я використовував операцію DELETE, а ідентифікатори елементів, які потрібно було видалити, були частиною заголовка HTTP.