Переименовать ресурс RESTful способом

Question

Какова наилучшая практика для переименования ресурса в режиме RESTful? Допустим, мои пользователи могут поддерживать именованные списки вещей с помощью uri

http://example.org/users/{userName}/lists/{listName}

Я хочу дать своим пользователям API для переименования определенного списка. Какой предпочтительный способ?

До сих пор я придумал следующее:

• POST к списку ресурсов с пост-данными "newname = ..."
• ПОСТАВИТЬ список в новый URI, а затем УДАЛИТЬ старый URI

Как правильно это сделать?

Answer 1

Первый шаг в порядке, но я советую вам не удалять старый URI, потому что каждая ссылка на этот ресурс будет разорвана. вместо этого верните HTTP-код 301 «Перемещено навсегда»

http://en.wikipedia.org/wiki/HTTP_301