Когда пользователь регистрируется в моем веб-приложении, я отправляю электронное письмо, чтобы проверить его почтовый ящик. В письме есть ссылка на такой ресурс:
GET /verify/{token}
Поскольку ресурс обновляется за кулисами, не нарушает ли это подход RESTful?
Как я могу сделать это в режиме RESTful?
То, о чем вы говорите, это не REST. REST предназначен для связи между машинами, а не для связи человека с машиной. Вы можете разработать сторонний клиент REST, который отправляет активацию в службу REST.
Вы можете использовать свой URI подтверждения в браузере для доступа к клиенту REST:
# user follows a hyperlink in the browser manually
GET example.com/client/v1/verify/{token}
# asking the client to verify the token
и после этого клиент REST получит гиперссылку для проверки от службы REST и отправит POST в службу в фоновом режиме.
# the REST client follows the hyperlinks given by the service automatically
# the REST client can run either on the HTTP client or server side
GET example.com/api/v1
# getting the starting page of the REST service
# getting the hyperlink for verification
POST example.com/api/v1/verification {token}
# following the verification hyperlink
Если у вас есть сторонний клиент REST на стороне сервера, то HTTP-запросы к службе REST будут полностью выполняться на сервере, и вы ничего не увидите об этом в браузере. Если у вас есть REST-клиент на стороне клиента, вы можете отправить POST в браузере с помощью AJAX CORS или попробовать отправить POST напрямую с помощью HTML-формы (не рекомендуется). В любом случае активация должна быть POST или PUT.
Это зависит от того, что вы пытаетесь сделать.
Например, он запускает электронное письмо после проверки пользователя? Если это так, это не идемпотентный метод, и вы должны использовать POST.
Пример:
POST /users/{id}/verify/{token}
Если метод не имеет никаких последствий, кроме обновления, я думаю, вам следует использовать PUT.
Вы не слишком много думаете об ОТДЫХЕ? С проверкой электронной почты вы хотите, чтобы пользователь мог просто щелкнуть ссылку из любого почтового агента пользователя, который он использует, поэтому вы получите простой GET на сервере (представленный как гиперссылка на пользователя) с токен либо в пути, либо как часть строки запроса:
GET http://example.com/verify-email/TOKEN
GET http://example.com/verify-email?token=TOKEN
Любой из них подходит для этого варианта использования. На самом деле это не ресурс, который вы получаете или создаете; просто триггер для некоторого процесса на бэкэнде.
Как вы думаете, почему это противоречит хорошему дизайну?
